mcp-weather

This MCP Weather Server extends Claude with real-time weather capabilities. It exposes two primary tools: get-forecast, which retrieves current weather conditions and forecasts for a given location specified by latitude and longitude, and get-alerts, which checks for active weather alerts in a specified US state. Once connected via the MCP interface, Claude can ask for current conditions, forecasts, or alerts, and receive structured, actionable weather data to inform decisions or provide timely notifications. The server is designed to integrate with Claude Desktop as a tool provider, enabling Claude to query weather data, generate weather-related narratives, and issue safety alerts when necessary.

To use the tools, ensure Claude Desktop is configured to connect to the MCP Weather Server. Claude will present the weather tools as available capabilities (hammer icon) once the MCP integration is active. You can then ask questions such as: "What's the weather like in San Francisco right now?", "Are there any weather alerts in Texas today?", or "What's the forecast for Chicago this weekend?" The server handles data retrieval from the National Weather Service API and returns structured results that Claude can incorporate into responses or follow-up actions.

Prerequisites:

• Node.js 16+ and npm
• Access to a working MCP-enabled Claude Desktop setup

Installation steps:

1. Clone the repository: git clone https://github.com/SterlingChin/mcp-weather-server.git cd mcp-weather-server

2. Install dependencies: npm install

3. Build the project: npm run build

4. Run the server (example): node build/index.js

5. Connect to Claude Desktop:

   • Open Claude Desktop configuration and add the MCP server configuration similar to: { "mcpServers": { "weather": { "command": "node", "args": [ "/absolute/path/to/your/mcp-weather-server/build/index.js" ] } } }
   • Save and restart Claude Desktop to ensure MCP tools are detected.

Notes and tips:

• This server uses the National Weather Service API for weather data; no authentication is required for basic endpoints, but be mindful of rate limits.
• The two tools are implemented in src/tools/get-forecast.ts and src/tools/get-alerts.ts; you can extend or customize these tools if you fork the repository.
• If Claude Desktop reports that the server cannot be found, verify the path provided in the Claude configuration and restart Claude Desktop.
• Build artifacts live under the build/ directory; ensure you point Claude Desktop to the built index.js (build/index.js) when wiring up the MCP server.
• Monitor logs for troubleshooting: check the process output and any MCP-related logs produced by Claude Desktop for errors or connectivity issues.