🧪 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

Related MCP server: MCP Weather Server

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:

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:

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):

Manually test server

Run:

✅ Success

If you see your tool in Claude and prompts generate valid responses, the integration is complete!