Weather MCP Server

A Model Context Protocol (MCP) server that provides weather information.

Installation

pnpm install

Usage

Start the Server

pnpm start

Run Tests

pnpm test

Using with MCP Inspector

To test your server with the MCP Inspector:

1. Install the Inspector (if not already installed):

npx @modelcontextprotocol/inspector

2. Configure the connection:

   • Command: npx

   • Args: tsx main.ts

   • Or use the full command: npx tsx /path/to/mcpWeather/main.ts

3. Test the tool:

   • Select the fetch-Weather tool

   • Enter a city name (e.g., "Bogotá")

   • Call the tool

Tools

fetch-Weather

Get the weather for a given location.

Parameters:

• city (string, required): City name like 'Bogotá'

Example:

{
  "city": "Bogotá"
}

Response:

{
  "content": [
    {
      "type": "text",
      "text": "The weather in Bogotá is sunny"
    }
  ]
}

Important Notes

⚠️ Zod Version: This project uses Zod v3.23.8 to match the MCP SDK requirements. Do not upgrade to Zod v4 as it will cause parameter registration issues.

Development

The server uses:

• MCP SDK: @modelcontextprotocol/sdk v1.20.0

• Zod: v3.23.8 (for parameter validation)

• TSX: v4 (for running TypeScript)