README.md•1.95 kB
# 🧪 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 via `uv 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.json` or `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
Example content:
```json
{
"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):
```bash
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
```
### Manually test server
Run:
```bash
uv --directory /ABSOLUTE/PATH/... run weather.py
```
## ✅ Success
If you see your tool in Claude and prompts generate valid responses, the integration is complete!