Skip to main content
Glama

MCP Weather Server

by ParthibanRajasekaran
npmGitHub
ISC License
4
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

MCP Data Server ๏ฟฝ

A comprehensive Model Context Protocol (MCP) server that provides various data services, starting with real-time weather data and designed for easy extension to other data sources.

๐Ÿš€ Features

  • Modular Architecture: Easy to extend with new data services

  • Real-time Weather Data: Get current weather conditions for any city

  • MCP Protocol Compliance: Fully compatible with the Model Context Protocol

  • TypeScript Support: Written in TypeScript for better type safety

  • Stdio Transport: Uses standard input/output for communication

  • Extensible Design: Ready for news, finance, sports, and other data services

๐Ÿ“‹ Prerequisites

  • Node.js (v18 or higher)

  • npm or yarn package manager

  • TypeScript support

๐Ÿ› ๏ธ Installation

  1. Clone the repository:

git clone https://github.com/ParthibanRajasekaran/mcp-weather.git cd mcp-weather

  1. Install dependencies:

npm install

  1. Build the project (optional):

npm run build

๐ŸŽฏ Usage

Running the Server

Development Mode

npm run dev

Production Mode

npm run build npm start

MCP Configuration

Add the following configuration to your MCP client's configuration file (.vscode/mcp.json):

{ "servers": { "mcp-data-server": { "type": "stdio", "command": "npx", "args": [ "-y", "tsx", "src/main.ts" ] } } }

๐Ÿ”ง Available Services

Weather Service

getWeather

Get current weather data for a specified city.

Parameters:

  • city (string): The name of the city to get weather for

Example Usage:

// MCP client call const weather = await mcpClient.callTool("getWeather", { city: "London" });

Response Format:

{ "latitude": 51.51147, "longitude": -0.13078308, "current": { "time": "2025-07-08T06:15", "temperature_2m": 13.9, "apparent_temperature": 11, "is_day": 1, "rain": 0 }, "hourly": { "time": [...], "temperature_2m": [...] } }

๐Ÿ”ฎ Future Services (Planned)

  • News Service: Get latest news from various sources

  • Finance Service: Stock prices, market data, cryptocurrency

  • Sports Service: Live scores, team statistics, schedules

  • Social Media Service: Trending topics, social metrics

  • Maps Service: Location data, directions, places

๐Ÿ—๏ธ Architecture

Project Structure

mcp-weather/ โ”œโ”€โ”€ src/ โ”‚ โ”œโ”€โ”€ main.ts # Main server entry point โ”‚ โ”œโ”€โ”€ services/ # Data service implementations โ”‚ โ”‚ โ””โ”€โ”€ weather.ts # Weather service โ”‚ โ”œโ”€โ”€ types/ # TypeScript type definitions โ”‚ โ”‚ โ”œโ”€โ”€ weather.ts # Weather-related types โ”‚ โ”‚ โ””โ”€โ”€ service.ts # Base service interfaces โ”‚ โ””โ”€โ”€ utils/ # Utility functions โ”‚ โ””โ”€โ”€ registry.ts # Service registry โ”œโ”€โ”€ .vscode/ โ”‚ โ””โ”€โ”€ mcp.json # MCP client configuration โ”œโ”€โ”€ package.json # Project dependencies and scripts โ”œโ”€โ”€ tsconfig.json # TypeScript configuration โ””โ”€โ”€ README.md # This file

Transport Layer

The server uses StdioServerTransport for communication:

  • Input: Standard input (stdin)

  • Output: Standard output (stdout)

  • Protocol: JSON-RPC over stdio

  • Benefits: Simple, reliable, and widely supported

Service Architecture

Each service follows this pattern:

// 1. Define types interface ServiceInput { /* ... */ } interface ServiceOutput { /* ... */ } // 2. Create service class class MyService { async getData(input: ServiceInput): Promise<string> { // Implementation } } // 3. Register with MCP server server.tool("myTool", "Description", schema, handler);

๐Ÿค– AI Assistant Integration

Claude Desktop (Available Now)

Your MCP server works with Claude Desktop out of the box! See docs/AI_INTEGRATION.md for setup instructions.

GitHub Copilot (Coming Soon)

GitHub Copilot doesn't support MCP yet, but your server is ready! See docs/GITHUB_COPILOT_INTEGRATION.md for:

  • Current workarounds using VS Code extensions

  • What to expect when MCP support is added

  • Example integration patterns

VS Code Extension Example

Check out examples/vscode-extension/ for a working example that integrates your MCP server with VS Code today!

๐Ÿ” MCP Inspector Integration

For debugging and development, you can use the MCP Inspector:

  1. Install the MCP Inspector:

npm install -g @modelcontextprotocol/inspector

  1. Run the inspector:

npx @modelcontextprotocol/inspector npx tsx src/main.ts

  1. Open the inspector in your browser at http://localhost:5173

๐Ÿงช Development

Adding New Services

  1. Create Type Definitions (src/types/myservice.ts):

export interface MyServiceInput { query: string; } export const MyServiceSchema = z.object({ query: z.string().describe("Your query parameter") });

  1. Implement Service (src/services/myservice.ts):

export class MyService { async getData(input: MyServiceInput): Promise<string> { // Your implementation return "Service response"; } }

  1. Register Tool (in src/main.ts):

server.tool( "myTool", "Description of my tool", MyServiceSchema, async ({ query }: { query: string }) => { const result = await myService.getData({ query }); return { content: [{ type: "text", text: result }] }; } );

Development Scripts

  • npm run dev - Run in development mode with hot reload

  • npm run build - Build the TypeScript project

  • npm start - Run the built project

  • npm test - Run all tests

  • npm run test:watch - Run tests in watch mode

  • npm run test:coverage - Run tests with coverage report

๐ŸŒ API Details

Weather Service API

  • Geocoding: https://geocoding-api.open-meteo.com/v1/search

  • Weather: https://api.open-meteo.com/v1/forecast

  • Rate Limit: Free tier, no authentication required

  • Model: UKMO Seamless (UK Met Office)

๐Ÿค Contributing

We welcome contributions for new data services! Here's how:

  1. Fork the repository

  2. Create a feature branch: git checkout -b feature/new-service

  3. Add your service following the architecture above

  4. Add tests and documentation

  5. Commit your changes: git commit -m 'Add new service'

  6. Push to the branch: git push origin feature/new-service

  7. Open a Pull Request

Service Guidelines

  • Each service should be self-contained in its own file

  • Use TypeScript for type safety

  • Include proper error handling

  • Add JSDoc comments for public methods

  • Follow the existing code style

๐Ÿ“„ License

This project is licensed under the ISC License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

๐Ÿ“ž Support

If you encounter any issues or have questions:

  1. Check the Issues page

  2. Create a new issue with detailed information

  3. Contact: rajasekaran.parthiban7@gmail.com

๐Ÿ”„ Changelog

v1.0.0

  • Initial release with weather service

  • Modular architecture for easy extension

  • MCP protocol compliance

  • TypeScript implementation

  • Stdio transport support

Made with โค๏ธ by ParthibanRajasekaran | Ready for extension to any data service! const server = new McpServer({ name: "MCP Weather Server", version: "1.0.0", description: "A server that provides weather data" });

## ๐Ÿ”ง Tools Available ### `getWeather` Retrieves current weather conditions and forecasts for a specified city. **Parameters:** - `city` (string): The name of the city to get weather data for **Returns:** - Current temperature, apparent temperature, and conditions - Hourly temperature forecast for the next 7 days - Location coordinates and timezone information **Example Usage:** ```typescript // Through MCP client const weatherData = await mcpClient.callTool("getWeather", { city: "London" });

๐Ÿ“ Project Structure

mcp-weather/ โ”œโ”€โ”€ .vscode/ โ”‚ โ””โ”€โ”€ mcp.json # MCP server configuration โ”œโ”€โ”€ weather/ โ”‚ โ””โ”€โ”€ main.ts # Main server implementation โ”œโ”€โ”€ package.json # Dependencies and scripts โ”œโ”€โ”€ tsconfig.json # TypeScript configuration โ””โ”€โ”€ README.md # This file

๐Ÿ” MCP Inspector Integration

To use with the MCP Inspector for debugging and development:

  1. Configure MCP Client: Add the server to your MCP configuration file (.vscode/mcp.json):

{ "servers": { "my-weather-server": { "type": "stdio", "command": "npx", "args": ["-y", "tsx", "weather/main.ts"] } } }

  1. Launch Inspector: The server can be inspected using MCP-compatible tools and inspectors.

  2. Debug Mode: Use the development server for real-time debugging:

npm run dev

๐ŸŒ API Integration

The server integrates with two Open-Meteo APIs:

Geocoding API

  • Endpoint: https://geocoding-api.open-meteo.com/v1/search

  • Purpose: Convert city names to coordinates

  • Features: Multi-language support, fuzzy matching

Weather API

  • Endpoint: https://api.open-meteo.com/v1/forecast

  • Purpose: Retrieve weather data using coordinates

  • Model: UK Met Office Seamless model (ukmo_seamless)

  • Data: Current conditions + hourly forecasts

๐Ÿ› ๏ธ Development

Available Scripts

# Development server with hot reload npm run dev # Build TypeScript to JavaScript npm run build # Start production server npm start # Run tests npm test

Adding New Features

  1. New Tools: Add tools to the server using the server.tool() method

  2. Enhanced Data: Extend the weather API calls to include more parameters

  3. Error Handling: Improve error handling for edge cases

๐ŸŒ Usage Examples

Basic Weather Query

// Get weather for London const result = await getWeather({ city: "London" }); // Current conditions console.log(`Temperature: ${result.current.temperature_2m}ยฐC`); console.log(`Feels like: ${result.current.apparent_temperature}ยฐC`); console.log(`Rain: ${result.current.rain}mm`);

Multi-City Comparison

const cities = ["London", "Paris", "New York", "Tokyo"]; const weatherData = await Promise.all( cities.map(city => getWeather({ city })) );

๐Ÿ” Error Handling

The server includes comprehensive error handling:

  • Invalid Cities: Returns helpful error messages for non-existent cities

  • API Failures: Graceful handling of network issues

  • Data Validation: Input validation using Zod schemas

๐Ÿ“Š Data Schema

Current Weather Response

interface WeatherResponse { latitude: number; longitude: number; timezone: string; current: { time: string; temperature_2m: number; apparent_temperature: number; is_day: number; rain: number; }; hourly: { time: string[]; temperature_2m: number[]; }; }

๐Ÿค Contributing

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

๐Ÿ“ License

This project is licensed under the ISC License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

๐Ÿ“ž Support

For questions or issues:

Built with โค๏ธ using the Model Context Protocol

Deploy Server
A
security โ€“ no known vulnerabilities
-
license - not tested
A
quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

A Model Context Protocol server that provides real-time weather data and forecasts for any city.

  1. ๐Ÿš€ Features
    1. ๐Ÿ“‹ Prerequisites
      1. ๐Ÿ› ๏ธ Installation
        1. ๐ŸŽฏ Usage
          1. Running the Server
          2. MCP Configuration
        2. ๐Ÿ”ง Available Services
          1. Weather Service
          2. ๐Ÿ”ฎ Future Services (Planned)
        3. ๐Ÿ—๏ธ Architecture
          1. Project Structure
          2. Transport Layer
          3. Service Architecture
        4. ๐Ÿค– AI Assistant Integration
          1. Claude Desktop (Available Now)
          2. GitHub Copilot (Coming Soon)
          3. VS Code Extension Example
        5. ๐Ÿ” MCP Inspector Integration
          1. ๐Ÿงช Development
            1. Adding New Services
            2. Development Scripts
          2. ๐ŸŒ API Details
            1. Weather Service API
          3. ๐Ÿค Contributing
            1. Service Guidelines
          4. ๐Ÿ“„ License
            1. ๐Ÿ™ Acknowledgments
              1. ๐Ÿ“ž Support
                1. ๐Ÿ”„ Changelog
                  1. v1.0.0
                2. ๐Ÿ“ Project Structure
                  1. ๐Ÿ” MCP Inspector Integration
                    1. ๐ŸŒ API Integration
                      1. Geocoding API
                      2. Weather API
                    2. ๐Ÿ› ๏ธ Development
                      1. Available Scripts
                      2. Adding New Features
                    3. ๐ŸŒ Usage Examples
                      1. Basic Weather Query
                      2. Multi-City Comparison
                    4. ๐Ÿ” Error Handling
                      1. ๐Ÿ“Š Data Schema
                        1. Current Weather Response
                      2. ๐Ÿค Contributing
                        1. ๐Ÿ“ License
                          1. ๐Ÿ™ Acknowledgments
                            1. ๐Ÿ“ž Support

                              Related Resources

                              Related MCP Servers

                              • Weather MCP

                                kaisumi
                                -
                                security
                                -
                                license
                                -
                                quality
                                A Model Context Protocol server that provides current weather information and 3-day forecasts for specified cities using the Open-Meteo API.
                                Last updated -

                              • Weather MCP Server

                                bobby169
                                A
                                security
                                -
                                license
                                A
                                quality
                                A Model Context Protocol server that provides current weather forecasts for specific locations and active weather alerts for US states.
                                Last updated -
                                2

                              • Weather MCP Server

                                alchaincyf
                                A
                                security
                                -
                                license
                                A
                                quality
                                A Model Context Protocol server that provides weather information and forecasts based on user location or address input.
                                Last updated -
                                6
                                2
                                4
                                MIT License
                                • Apple

                              • Weather MCP

                                LiuKeTong713
                                -
                                security
                                -
                                license
                                -
                                quality
                                A Model Context Protocol server that enables natural language weather queries for global cities, integrating with OpenWeather API to provide real-time weather information in an easy-to-read format.
                                Last updated -

                              View all related MCP servers

                              New MCP Servers

                              MCP directory API

                              We provide all the information about MCP servers via our MCP API.

                              curl -X GET 'https://glama.ai/api/mcp/v1/servers/ParthibanRajasekaran/mcp-weather'

                              If you have feedback or need assistance with the MCP directory API, please join our Discord server