MCP Weather Server

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

Clone the repository:

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

Install dependencies:

npm install

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:

Install the MCP Inspector:

npm install -g @modelcontextprotocol/inspector

Run the inspector:

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

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

🧪 Development

Adding New Services

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

export interface MyServiceInput {
    query: string;
}

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

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

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

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:

Fork the repository
Create a feature branch: git checkout -b feature/new-service
Add your service following the architecture above
Add tests and documentation
Commit your changes: git commit -m 'Add new service'
Push to the branch: git push origin feature/new-service
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

Model Context Protocol for the protocol specification
Open-Meteo for the free weather API
TypeScript for type safety

📞 Support

If you encounter any issues or have questions:

Check the Issues page
Create a new issue with detailed information
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:

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"]
        }
    }
}

Launch Inspector: The server can be inspected using MCP-compatible tools and inspectors.
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

New Tools: Add tools to the server using the server.tool() method
Enhanced Data: Extend the weather API calls to include more parameters
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

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

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

🙏 Acknowledgments

Open-Meteo for providing free weather data
Model Context Protocol for the MCP specification
UK Met Office for the weather model data

📞 Support

For questions or issues:

Create an issue on GitHub
Check the MCP Documentation

Built with ❤️ using the Model Context Protocol

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

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.

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

Related MCP Servers

Weather MCP
kaisumi
-
security
F
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 -
Python
Weather MCP Server
bobby169
A
security
F
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
TypeScript
MCP Weather Server
aaudeon
A
security
F
license
A
quality
A Model Context Protocol server that provides real-time weather information and 5-day forecasts to AI assistants, supporting multiple languages and flexible units.
Last updated -
3
8
TypeScript
Weather MCP Server
alchaincyf
-
security
A
license
-
quality
A Model Context Protocol server that provides weather information and forecasts based on user location or address input.
Last updated -
14
1
TypeScript
MIT License

View all related MCP servers

MCP Data Server �

🚀 Features

📋 Prerequisites

🛠️ Installation

🎯 Usage

Running the Server

Development Mode

Production Mode

MCP Configuration

🔧 Available Services

Weather Service

getWeather

🔮 Future Services (Planned)

🏗️ Architecture

Project Structure

Transport Layer

Service Architecture

🤖 AI Assistant Integration

Claude Desktop (Available Now)

GitHub Copilot (Coming Soon)

VS Code Extension Example

🔍 MCP Inspector Integration

🧪 Development

Adding New Services

Development Scripts

🌐 API Details

Weather Service API

🤝 Contributing

Service Guidelines

📄 License

🙏 Acknowledgments

📞 Support

🔄 Changelog

v1.0.0

📁 Project Structure

🔍 MCP Inspector Integration

🌐 API Integration

Geocoding API

Weather API

🛠️ Development

Available Scripts

Adding New Features

🌍 Usage Examples

Basic Weather Query

Multi-City Comparison

🔐 Error Handling

📊 Data Schema

Current Weather Response

🤝 Contributing

📝 License

🙏 Acknowledgments

📞 Support

Related MCP Servers

Weather MCP

Weather MCP Server