modelcontextprotocol / modelcontextprotocol/servers

Using SOCKS proxy, but the 'socksio' package is not installed.

Open
#1,401 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
TypeScript
Stars
90.5k
Forks
11.7k
Avg merge
2d 2h
Merged PRs (30d)
5

Description

Describe the bug
When I configure the use of fetch in cursor mcp, the configuration takes effect, but when fetch is triggered, an error always occurs:Using SOCKS proxy, but the 'socksio' package is not installed. Make sure to install httpx using pip install httpx[socks].

To Reproduce
Steps to reproduce the behavior:
cursor mcp config:

{
  "mcpServers": {
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": {
        "BRAVE_API_KEY": "xxxxx"
      }
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

Expected behavior
My device has already installed uv, and the error still exists after performing the following operations:

  1. uv venv

  2. source .venv/bin/activate

  3. uv pip install "httpx[socks]"

Similarly, I also tried using brew install pipx, pipx install "httpx[socks]", but the error still exists.

Logs
If applicable, add logs to help explain your problem.

Additional context
Add any other context about the problem here.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the mcp-server-fetch command launched by uvx and verify which environment supplies its httpx dependency. Reproduce the SOCKS configuration from the issue and trace why installing httpx[socks] in a separate virtual environment does not affect that command. Done means the fetch server runs without the socksio error.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
networking
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.