mcpField
W
Weather MCP Server

Weather MCP Server

Local
github.com/AnnihilaterMedia & Design0Updated 83w ago
Repository

About Weather MCP Server

Weather MCP Server is a lightweight service for retrieving current weather by city name. It returns temperature, conditions, humidity, and wind speed, and can use generated data when an external API is unavailable.

Key features

  1. 01Current weather lookup by city
  2. 02Temperature and condition details
  3. 03Humidity and wind speed data
  4. 04Generated-data fallback

Use cases

  1. 01Check current conditions in a city
  2. 02Retrieve weather details for an assistant response

MCP support

It exposes a get_weather tool to MCP clients, accepting a city name and returning current weather information.

#weather#mcp-server#weather-api

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "get-weather": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
Run commandnpx -y @modelcontextprotocol/inspector

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@modelcontextprotocol/inspector

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Weather MCP Server

中文文档 | English

A simple weather information service built with Model Context Protocol (MCP).

Overview

Weather MCP Server provides weather information for cities around the world through a simple API interface. It uses the Model Context Protocol (MCP) to communicate with clients, allowing easy integration with AI assistants and other MCP-compatible applications.

Features

  • Get current weather conditions by city name
  • Returns temperature, weather description, humidity, and wind speed
  • Fallback to generated data if external API is unavailable
  • Simple and lightweight implementation

Tech Stack

  • TypeScript
  • Node.js
  • MCP SDK (@modelcontextprotocol/sdk)
  • Zod for validation

Installation

  1. Clone the repository
git clone https://github.com/Annihilater/mcp-server-get-weather
  1. Install dependencies:
npm install
  1. Build the project:
npm run build

Usage

Start the server:

npx @modelcontextprotocol/inspector node dist/index.js

MCP Configuration

要在Cursor中使用此天气服务，需要在~/.cursor/mcp.json文件中添加以下配置：

"mcp-server-get-weather": {
  "command": "node",
  "args": [
    "<path-to-your-project>/dist/index.js"
  ]
}

将<path-to-your-project>替换为实际项目路径。配置完成后，可以通过MCP工具调用mcp_mcp_server_get_weather_get_weather函数来获取天气信息。

Example

MCP Config MCP Usage

API Reference

get_weather

Gets weather information for a specified city.

Parameters
NameTypeDescription
cityNamestringThe name of the city to get weather for
Response

Returns a JSON object with the following structure:

{
  "city": "London",
  "current_condition": {
    "temperature": "15",
    "weatherDesc": "Partly cloudy",
    "humidity": "71",
    "windSpeed": "11",
    "observation_time": "06:53 PM"
  },
  "forecast": {
    "maxTemp": "16",
    "minTemp": "9",
    "sunHour": "7.4",
    "date": "2023-04-12"
  }
}

Development

Available Scripts
  • npm run build - Builds the project and makes the entry point executable
  • npm run watch - Watches for changes and rebuilds automatically
  • npx @modelcontextprotocol/inspector node dist/index.js - Starts the server
Project Structure
  • src/index.ts - Entry point, sets up the MCP server with stdio transport
  • src/server.ts - Server implementation, defines the weather tool

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.