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

{ "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!

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Tools

A Model Context Protocol server that provides real-time weather data to AI clients through Server-Sent Events, enabling them to fetch current weather conditions, multi-day forecasts, and location-based weather information.

Related MCP Servers

Weather MCP Server
akaramanapp
A
security
F
license
A
quality
A Model Context Protocol server that provides AI agents with tools to retrieve weather alerts and detailed forecasts for US locations using the National Weather Service API.
Last updated -
2
60
MCP Weather Server
aaudeon
A
security
F
license
A
quality
A Model Context Protocol server that provides real-time weather information and 5-day forecasts to AI assistants, supporting multiple languages and flexible units.
Last updated -
3
3
Weather MCP Server
mauricioTechDev
-
security
F
license
-
quality
A Model Context Protocol server that enables AI models to fetch weather alerts and detailed forecasts for US locations using the National Weather Service API.
Last updated -
60
OpenWeatherMap MCP Server
robertn702
A
security
A
license
A
quality
A Model Context Protocol server that provides comprehensive weather data and forecasts through the OpenWeatherMap API, enabling AI assistants to access real-time weather information, forecasts, air quality data, and location services.
Last updated -
11
32
MIT License

View all related MCP servers

MCP Weather SSE Server