mcpField
W
Weather MCP Server

Weather MCP Server

本地服务
github.com/Annihilater媒体与设计083 周前更新
代码仓库

关于 Weather MCP Server

Weather MCP Server 是一项轻量级服务，可按城市名称查询当前天气，返回温度、天气描述、湿度和风速；外部 API 不可用时可回退到生成数据。

主要功能

  1. 01按城市查询当前天气
  2. 02提供温度与天气描述
  3. 03提供湿度和风速数据
  4. 04外部 API 故障时生成数据

适用场景

  1. 01查询某城市当前天气
  2. 02为助手回复获取天气详情

MCP 相关

它向 MCP 客户端提供 get_weather 工具，接收城市名称并返回当前天气信息。

#weather#mcp-server#weather-api

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "get-weather": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}
启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@modelcontextprotocol/inspector

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Weather MCP Server

中文文档 | English

一个基于 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
  1. 安装依赖：
npm install
  1. 构建项目：
npm run build

使用

启动服务：

npx @modelcontextprotocol/inspector node dist/index.js

MCP 配置

要在 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 函数来获取天气信息。

示例

MCP 配置 MCP 使用

API 参考

get_weather

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

参数
名称类型描述
cityNamestring要获取天气信息的城市名称
响应

返回一个具有以下结构的 JSON 对象：

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

开发

可用脚本
  • npm run build - 构建项目并使入口点可执行
  • npm run watch - 监视变更并自动重新构建
  • npx @modelcontextprotocol/inspector node dist/index.js - 启动服务
项目结构
  • src/index.ts - 入口点，使用 stdio 传输设置 MCP 服务
  • src/server.ts - 服务实现，定义天气工具

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。