Skip to content

Commit 7fc3d2d

Browse files
authored
Merge pull request #2565 from modelcontextprotocol/claude/issue-65-20250817-1645
docs(fetch): Add Windows PYTHONIOENCODING configuration
2 parents e98c180 + 3dd0db0 commit 7fc3d2d

1 file changed

Lines changed: 42 additions & 0 deletions

File tree

src/fetch/README.md

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,48 @@ This can be customized by adding the argument `--user-agent=YourUserAgent` to th
168168

169169
The server can be configured to use a proxy by using the `--proxy-url` argument.
170170

171+
## Windows Configuration
172+
173+
If you're experiencing timeout issues on Windows, you may need to set the `PYTHONIOENCODING` environment variable to ensure proper character encoding:
174+
175+
<details>
176+
<summary>Windows configuration (uvx)</summary>
177+
178+
```json
179+
{
180+
"mcpServers": {
181+
"fetch": {
182+
"command": "uvx",
183+
"args": ["mcp-server-fetch"],
184+
"env": {
185+
"PYTHONIOENCODING": "utf-8"
186+
}
187+
}
188+
}
189+
}
190+
```
191+
</details>
192+
193+
<details>
194+
<summary>Windows configuration (pip)</summary>
195+
196+
```json
197+
{
198+
"mcpServers": {
199+
"fetch": {
200+
"command": "python",
201+
"args": ["-m", "mcp_server_fetch"],
202+
"env": {
203+
"PYTHONIOENCODING": "utf-8"
204+
}
205+
}
206+
}
207+
}
208+
```
209+
</details>
210+
211+
This addresses character encoding issues that can cause the server to timeout on Windows systems.
212+
171213
## Debugging
172214

173215
You can use the MCP inspector to debug the server. For uvx installations:

0 commit comments

Comments
 (0)