MCP Weather Server

A ready-to-use implementation of the Model Context Protocol (MCP) that extends Claude with real-time weather data capabilities.

What is MCP?

Model Context Protocol (MCP) is an open communication framework that allows AI models like Claude to interact with external tools. This enables Claude to access real-time data, process files, and interact with external services - capabilities not available to most LLMs out of the box.

Learn more about MCP:

• MCP Official Documentation
• Getting Started with MCP
• Postmans MCP Developer Community

What This Repository Contains

This repository provides:

1. Complete MCP Weather Server: A fully functional implementation that gives Claude access to real-time weather data
2. Template Code: Use as a starting point for your own MCP projects
3. Configuration Examples: Sample configuration files for connecting to Claude Desktop

Features

The MCP Weather Server implements two primary tools:

• get-forecast: Retrieve current weather conditions and forecasts for any location by latitude/longitude
• get-alerts: Check for active weather alerts in any US state

Once connected, Claude can:

• Answer questions about current weather conditions
• Provide detailed weather forecasts
• Alert users to severe weather warnings
• Make recommendations based on weather data

Quick Start

Prerequisites

• Node.js 16+ and npm
• Claude Desktop
• Basic knowledge of TypeScript/JavaScript

Installation

1. Clone this 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
   

Connecting to Claude Desktop

1. Open your Claude Desktop configuration file:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %AppData%\Claude\claude_desktop_config.json

2. Add the following configuration (update the path to point to your repository):

   {
     "mcpServers": {
       "weather": {
         "command": "node",
         "args": [
           "/absolute/path/to/your/mcp-weather-server/build/index.js"
         ]
       }
     }
   }
   

3. Restart Claude Desktop

4. Look for the hammer icon in Claude Desktop, indicating that MCP tools are available

Testing Your Implementation

Try asking Claude these questions:

• "What's the weather like in San Francisco right now?"
• "Are there any weather alerts in Texas today?"
• "What's the forecast for Chicago this weekend?"

Project Structure

├── src/
│   ├── index.ts           # Main server entry point
│   ├── tools/             # Tool implementations
│   │   ├── get-forecast.ts
│   │   └── get-alerts.ts
│   └── utils/             # Helper functions and API client
│       └── nws-api.ts
├── build/                 # Compiled JavaScript files
├── examples/              # Example code and usage patterns
├── docs/                  # Additional documentation
├── package.json
└── tsconfig.json

Building Your Own MCP Server

This repository can serve as a template for building your own MCP servers. Follow these steps:

1. Fork this repository or create a new one based on its structure
2. Replace the weather API implementation with your own service
3. Define your tools by adding new files in the src/tools directory
4. Register your tools in src/index.ts
5. Build and test your implementation

For detailed guidance, check

... View full README on GitHub