Weather MCP Server

# Weather MCP Server A simple Model Context Protocol (MCP) server built with TypeScript that provides weather information using the Open-Meteo API. ## Features - 🌤️ **Get Weather**: Fetch current weather data for any city worldwide - 👋 **Greet**: Simple greeting tool for testing - 🌍 Uses free Open-Meteo API (no API key required) - 🚀 Built with MCP TypeScript SDK - 📡 HTTP transport support ## Prerequisites - Node.js 18+ - npm or yarn ## Installation 1. Install dependencies: ```bash npm install ``` ## Usage ### Development Mode Run the server with auto-reload: ```bash npm run dev ``` ### Production Mode 1. Build the TypeScript code: ```bash npm run build ``` 2. Start the server: ```bash npm start ``` The server will start on `http://localhost:3000/mcp` by default. You can change the port by setting the `PORT` environment variable: ```bash PORT=8080 npm run dev ``` ## Connecting to the Server ### Using MCP Inspector The easiest way to test your server: ```bash npx @modelcontextprotocol/inspector ``` Then connect to: `http://localhost:3000/mcp` ### Using Claude Code ```bash claude mcp add --transport http weather-server http://localhost:3000/mcp ``` ### Using VS Code ```bash code --add-mcp "{\"name\":\"weather-server\",\"type\":\"http\",\"url\":\"http://localhost:3000/mcp\"}" ``` ### Using Cursor Click [this deeplink](cursor://anysphere.cursor-deeplink/mcp/install?name=weather-server&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjMwMDAvbWNwIn0%3D) ## Available Tools ### 1. get-weather Get current weather information for any city. **Input:** ```json { "city": "Sydney" } ``` **Output:** ```json { "city": "Sydney, Australia", "temperature": 22.5, "weatherCode": 0, "windSpeed": 15.2, "humidity": 65, "description": "Clear sky" } ``` **Example queries:** - "What's the weather in Tokyo?" - "Get me the current temperature in London" - "How's the weather in New York?" ### 2. greet Simple greeting tool for testing the server. **Input:** ```json { "name": "Alice" } ``` **Output:** ```json { "greeting": "Hello, Alice! Welcome to the Weather MCP Server!" } ``` ## API Information This server uses the free [Open-Meteo API](https://open-meteo.com/) which provides: - Current weather conditions - No API key required - Global coverage - Reliable geocoding ## Project Structure ``` weather-mcp-server/ ├── src/ │ └── index.ts # Main server implementation ├── dist/ # Compiled JavaScript (generated) ├── package.json # Dependencies and scripts ├── tsconfig.json # TypeScript configuration └── README.md # This file ``` ## Development The server is built using: - **@modelcontextprotocol/sdk**: MCP TypeScript SDK - **Express**: HTTP server - **Zod**: Schema validation - **TypeScript**: Type safety ## Health Check The server includes a health check endpoint: ```bash curl http://localhost:3000/health ``` Response: ```json { "status": "ok", "server": "weather-mcp-server", "version": "1.0.0" } ``` ## Troubleshooting ### Port already in use If port 3000 is already in use, specify a different port: ```bash PORT=8080 npm run dev ``` ### City not found Make sure you're using the correct city name. The API uses geocoding to find cities, so try: - Full city names: "New York" instead of "NYC" - Including country if ambiguous: "London, UK" or "London, Ontario" ## License MIT