🧪 MCP Server for Claude Desktop
This guide shows you how to use your Model Context Protocol (MCP) server using Claude for Desktop.
1. Requirements
- Claude/Cursor for Desktop (Windows or macOS)
- MCP server script (e.g.,
weather.py,'map.py') running viauv run weather.py
2. Configure Claude to Launch the MCP Server
Create or edit the Claude config file:
- macOS/Linux:
~/.config/claude/claude_desktop_config.jsonor~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Example content:
{
"mcpServers": {
"weather": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
"run",
"weather.py"
]
}
}
}
Replace /ABSOLUTE/PATH/... with the actual absolute path to the folder containing weather.py.
3. Restart Claude
Close and reopen Claude for Desktop. If configured correctly, a tool icon will appear at the bottom-left of the chat window.
4. Test Your Tool
Click the tool icon to see your MCP server tools like search-location and get-forecast.
Try prompts such as:
What’s the weather in Vinh, VietNam?
Find the restaurant near Ho Guom ?
Claude should use your local server to respond.
5. Troubleshooting
If you don’t see your server or tool in Claude:
Check config
- Ensure JSON syntax is valid.
- Use absolute paths, not relative ones.
Check logs
Logs may be found in:
- macOS/Linux:
~/Library/Logs/Claude/mcp.log - Windows:
%APPDATA%\Claude\Logs\mcp.log
You can tail logs like this (macOS/Linux):
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
Manually test server
Run:
uv --directory /ABSOLUTE/PATH/... run weather.py
✅ Success
If you see your tool in Claude and prompts generate valid responses, the integration is complete!