A simple Model Context Protocol (MCP) server that provides temperature information for popular cities around the world. This server exposes a single tool get_temperature that returns dummy temperature data for demonstration purposes.

Features

Single MCP tool: get_temperature
Supports 20+ popular cities worldwide
Returns temperature in Celsius or Fahrenheit
Includes weather conditions
Uses dummy/mock data (no external API calls)

Installation

npm install

Build

npm run build

Usage

Running the Server

The server runs on stdio transport (standard input/output) by default:

npm start

Using with MCP Clients

This server can be used with any MCP-compatible client. Add it to your client configuration:

{
  "mcpServers": {
    "temperature": {
      "command": "node",
      "args": ["/path/to/temperature-mcp/dist/index.js"]
    }
  }
}

Available Tool

get_temperature

Get the current temperature for a popular city.

Input:

location (string, required): The name of the city

Example:

{
  "location": "New York"
}

Output:

Temperature in New York: 72°F
Condition: Partly Cloudy

Supported Cities

The server provides temperature data for the following cities:

New York, Los Angeles, San Francisco, Chicago (USA)
London, Paris, Berlin, Moscow (Europe)
Tokyo, Beijing, Shanghai, Hong Kong, Seoul, Singapore (Asia)
Sydney (Australia)
Dubai (Middle East)
Mumbai (India)
Toronto (Canada)
Mexico City (Mexico)
Rio de Janeiro (Brazil)

Development

To run in development mode:

npm run dev

Architecture

This server demonstrates:

TypeScript MCP server implementation
Tool registration and execution
Input validation using Zod
Stdio transport for communication
Error handling and user-friendly messages

Note

This server uses dummy data for demonstration purposes. In a production environment, you would integrate with a real weather API service.