天气 MCP 服务器

English Document | 中文

一个使用 Model Context Protocol (MCP) 构建的简单天气信息服务平台。

概述

Weather MCP Server 提供全球各地城市的天气信息查询服务，通过简单的 API 接口实现。它利用 Model Context Protocol（MCP）与客户端进行通信，便于与 AI 助手和其他兼容 MCP 的应用程序集成。

特性

• 通过城市名称获取当前天气状况
• 返回温度、天气描述、湿度和风速信息
• 外部 API 不可用时，提供生成数据作为备用方案
• 简单轻量的实现方式

技术栈

• TypeScript
• Node.js
• MCP SDK (@modelcontextprotocol/sdk)
• Zod 用于验证

安装指南

1. 克隆仓库：

git clone https://github.com/Annihilater/mcp-server-get-weather

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

使用方法

启动服务器：

npx @modelcontextprotocol/inspector node dist/index.js

MCP 配置

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

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

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

示例

API 参考

get_weather

获取指定城市的天气信息。

参数

响应

返回一个 JSON 对象，结构如下：

{
  "city": "London",
  "current_condition": {
    "temperature": "15",
    "weatherDesc": "部分多云",
    "humidity": "71",
    "windSpeed": "11",
    "observation_time": "下午 06:53"
  },
  "forecast": {
    "maxTemp": "16",
    "minTemp": "9",
    "sunHour": "7.4",
    "date": "2023-04-12"
  }
}

开发信息

可用脚本命令

• npm run build - 构建项目并生成可执行入口
• npm run watch - 监控文件变化，自动重建
• npx @modelcontextprotocol/inspector node dist/index.js - 启动服务器

项目结构

• src/index.ts - 入口文件，设置 MCP 服务器并使用 stdio 运输
• src/server.ts - 服务器实现文件，定义天气工具

许可证

MIT