GNOME 系统代理的 `socks://` 格式导致连接失败

[shuiyell]

问题描述

当使用配置了 SOCKS 代理的 GNOME 系统代理时，grok-search MCP 服务器会报错：

● grok-search - web_search (MCP)(query: "test search", max_results: 3)
  ⎿  Error: Error calling tool 'web_search': Unknown scheme for proxy URL 
     URL('socks://127.0.0.1:7897/')

环境信息

• 操作系统: Linux - Ubuntu 24.04(GNOME 桌面环境)
• 代理工具: Clash / v2ray / 任何 SOCKS5 代理

原因

1. GNOME 系统代理在配置 SOCKS 代理时会自动生成 ALL_PROXY=socks://127.0.0.1:PORT/
2. httpx 0.28.0+ 只接受标准 SOCKS 格式：socks5:// 或 socks5h://

解决方案

用户可以通过在 MCP 配置中设置 ALL_PROXY="" 来解决此问题：

{
   "mcpServers": {
     "grok-search": {
       "command": "uvx",
       "args": [
         "--from",
         "git+https://github.com/GuDaStudio/GrokSearch",
         "grok-search"
       ],
       "env": {
         "GROK_API_KEY": "...",
         "GROK_API_URL": "...",
         "ALL_PROXY": "" //添加此行
       }
     }
   }
 }

确实是少数人才会遇到，所以倒也没必要从代码上调整