Best for
- Developers looking to integrate real-time weather into Claude Desktop
- Use cases requiring caching for faster responses
- Developers interested in Clean Architecture and SOLID principles
W
Weather MCP Server
Community
A comprehensive MCP server for real-time weather data with Claude Desktop
GitHub source repository ↗
50FMRS · D
This project is a well-featured weather MCP server with a clean architecture and clear tool interfaces. Suitable for developers wanting to integrate weather queries into Claude.
The Weather MCP Server is a TypeScript-based MCP server built with Clean Architecture and SOLID principles. It enables Claude Desktop to query real-time weather, 5-day forecasts, history, and cache statistics via OpenWeatherMap, PostgreSQL, and Redis.
Tools
get_current_weather
Retrieves current weather conditions for any city.
get_weather_forecast
Provides a 5-day weather forecast.
get_weather_history
Returns past weather query records.
get_cache_statistics
Shows Redis cache performance statistics.
Setup
- Clone repository: git clone https://github.com/glaucia86/weather-mcp-server.git
- Install dependencies: npm install
- Copy .env.example to .env and configure WEATHER_API_KEY, DATABASE_URL, REDIS_URL
- Build project: npm run build
- Start infrastructure: npm run docker:up
- Configure Claude Desktop's claude_desktop_config.json with the provided JSON.
claude_desktop_config.json
{
"mcpServers": {
"weather-mcp": {
"command": "node",
"args": [
"/caminho/completo/para/weather-mcp-server/dist/mcp-entry.js"
],
"env": {
"WEATHER_API_KEY": "SUA_API_KEY_OPENWEATHERMAP",
"DATABASE_URL": "postgresql://mcp_user:mcp_pass@localhost:5432/weather_mcp",
"REDIS_URL": "redis://localhost:6379",
"NODE_ENV": "production",
"LOG_LEVEL": "error",
"MCP_MODE": "true"
}
}
}
}
Fit and risk
Not for
- Users without an OpenWeatherMap API key
- Simple use cases that don't require caching or a database
- Users who cannot run Docker environments
Required permissions
- Access to external OpenWeatherMap API
- Read/write to PostgreSQL database (for query history)
- Read/write to Redis cache
- Read API keys from environment variables
Risks and side effects
- API key exposure if not securely stored
- Database and Redis unavailability could cause failures
- Cache data may become stale, leading to inaccurate info
- Dependency on external OpenWeatherMap API, which might have rate limits or downtime
Troubleshooting
- If 'Cannot find module', run rm -rf node_modules package-lock.json; npm cache clean --force; npm install; npm run build
- If MCP doesn't connect to Claude Desktop, verify the path in claude_desktop_config.json is correct, ensure dist/mcp-entry.js exists, and completely restart Claude Desktop
- If PostgreSQL connection refused, run npm run docker:down and npm run docker:up, then wait 30 seconds
Use cases
Query current weather for any city in real-time
Get a 5-day weather forecast
Review history of past weather queries
Monitor cache system performance
Supported clients
Claude DesktopFull support