天气数据服务

一个基于Model Context Protocol (MCP)的服务器,通过Open-Meteo API提供实时天气信息。

  • by krishanuc1001
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 krishanuc1001/weather-mcp-server

使用说明

气象MCP服务器

一个简单的模型上下文协议(MCP)服务器,使用Open-Meteo API为任何城市提供实时天气信息。

特性

  • 按名称获取任何城市的当前天气
  • 返回温度、湿度等信息
  • 易于运行和扩展

运作原理

此服务器公开了一个工具:

  • 获取天气:提供城市名称,并获取该地点的当前天气。

用法

1.先决条件

2.安装依赖项

npm install

3.启动MCP服务器

npx -y tsx main.ts

您应该看到:

MCP Server is running and waiting for requests...

4.如何使用

您可以使用任何兼容MCP的客户端或工具连接到此服务器。服务器公开了一个名为 get-Weather 它采用城市名称并返回当前天气数据。

示例请求

{
  "tool": "get-Weather",
  "params": {
    "city": "Kolkata"
  }
}

示例响应

{
  "temperature_2m": 28.2,
  "relative_humidity_2m": 88,
  ...
}

项目结构

  • main.ts --主服务器代码
  • package.json --项目依赖关系
  • .vscode/mcp.json --MCP服务器配置

定制

您可以轻松扩展服务器以添加更多工具或获取更多天气数据。看 main.ts 为了实施。

附加信息:在本地运行MCP检查器

这 MCP检查员 是一个强大的开发工具,用于通过可视化界面或命令行测试和调试MCP服务器。

快速启动(UI模式)

您可以在本地运行检查器UI,而无需克隆存储库:

npx @modelcontextprotocol/inspector
  • Inspector UI将在 http://localhost:6274.
  • 会话令牌将在终端中打印。浏览器将自动打开,并预先填充令牌进行身份验证。

连接到您的天气MCP服务器

  1. 启动天气MCP服务器 (在单独的终端中):
    npx -y tsx main.ts
    
  2. 在检查器UI中,单击“添加服务器”并将其配置为使用 main.ts stdio传输的入口点:
    • 命令: npx
    • Args: -y tsx main.ts
    • (或者,使用您的 .vscode/mcp.json 便于设置)
  3. 连接和互动 使用Inspector的可视化界面与服务器进行交互。

高级:从源代码运行检查器

如果要开发或自定义检查器本身:

git clone https://github.com/modelcontextprotocol/inspector.git
cd inspector
npm install
npm run dev

命令行接口命令模式

您还可以从命令行使用检查器进行脚本编写和自动化:

npx @modelcontextprotocol/inspector --cli npx -y tsx main.ts

有关更多详细信息和配置选项,请参阅 官方检查员文件.