🚀 MCP 天气服务器

本项目是一个用 TypeScript 实现的 Model Context Protocol (MCP) 服务器，借助 Server-Sent Events (SSE) 协议为用户提供便捷的天气信息查询工具。它突破了传统本地通信的局限，通过 HTTP 实现远程连接，让客户端能通过网络轻松获取天气数据。

🚀 快速开始

MCP 天气服务器实现了模型上下文协议，借助 SSE 运输协议，为用户提供天气预报与预警工具。与常见的使用本地通信的 stdio 标准示例不同，此服务器通过 HTTP 实现远程连接，允许客户端通过网络进行连接。

启动服务器：

node build/index.js

这将默认在端口 3001 上运行服务器。您应该会看到类似以下的输出：

天气 MCP 服务器正在 http://localhost:3001 运行
请客户端连接到 http://localhost:3001/sse

测试服务器

可以通过以下命令测试服务器是否正常运行：

curl http://localhost:3001/sse

这将返回一个带有会话 ID 的事件。

✨ 主要特性

• 基于 SSE 运输协议实现 MCP。
• 提供两个实用的天气工具：
  • get-forecast：可获取特定坐标点的天气预报。
  • get-alerts：能获取美国各州的活跃天气预警。
• 连接到美国国家气象局（NWS）API，数据权威可靠。
• 支持多个客户端同时连接，满足多人使用需求。

📦 安装指南

# 克隆仓库
git clone https://github.com/tyfeng1997/mcp-server.git
cd mcp-server

# 安装依赖项
npm install

# 编译 TypeScript 代码
npm run build

💻 使用示例

可用工具

该服务器提供了两个工具：

1. get-forecast

• 描述：获取某个位置的天气预报。
• 参数：
  • latitude（number）：位置的纬度 (-90 到 90)。
  • longitude（number）：位置的经度 (-180 到 180)。
• 注意：仅支持美国地区的 NWS API。

2. get-alerts

• 描述：获取某个州的天气预警。
• 参数：
  • state（string）：两位字母的美国州代码（例如 CA、NY）。

📚 详细文档

伴侣客户端

该服务器设计用于与 MCP 客户端配合使用，可在 tyfeng1997/mcp-client 找到。客户端连接到此服务器，并允许像 Claude 这样的 AI 助手通过自然语言使用天气工具。

自定义配置

端口配置

要更改端口，请在代码中修改 PORT 常量：

const PORT = 3001; // 更改为您所需的端口

添加更多工具

可以通过以下模式添加更多工具：

server.tool(
  "your-tool-name",
  "您的工具描述",
  {
    // 参数 schema 使用 zod
    param1: z.string().describe("参数描述"),
    param2: z.number().describe("参数描述"),
  },
  async ({ param1, param2 }) => {
    // 工具实现
    return {
      content: [
        {
          type: "text",
          text: "工具结果",
        },
      ],
    };
  }
);

贡献指南

欢迎贡献！请随意提交 Pull Request。

📄 许可证

该项目使用 MIT 许可证，详细信息请参阅 LICENSE 文件。