Aviation Weather MCP Server

Aviation Weather MCP Server

这是一个 Model Context Protocol（MCP）服务，可为飞行计划提供航空天气信息。它连接到 Aviation Weather API，以获取 METAR、TAF、PIREP 和其他数据。

免责声明

请勿将此工具用于飞行计划或飞行中的决策。

重要免责声明： 此 Aviation Weather MCP 服务提供来自 aviationweather.gov 的天气数据，仅供参考。绝不可将此工具提供的信息作为飞行计划或飞行中决策的唯一信息来源。

天气数据可能不完整、延迟或不准确。此外，解读这些数据的大模型也可能误解或错误呈现关键信息。每次飞行前，请务必查阅官方航空天气来源，并向授权服务提供商获取适当的天气简报。

此工具未经 FAA 批准，不能替代经过认证的天气服务，只应作为补充参考。开发者对基于此工具提供的信息所做出的决定概不负责。

务必通过官方渠道核实关键信息。

功能

• 类型安全的 API 客户端，根据官方 Aviation Weather API Swagger 定义自动生成
• 用于天气数据的 MCP 工具：
  • get-metar：获取当前天气观测数据
  • get-taf：获取终端机场预报
  • get-pireps：获取机场附近的飞行员报告
  • get-route-weather：获取两个机场之间航线的综合天气信息

设置

先决条件

• Node.js 18 或更高版本
• npm 或 yarn
• curl（用于获取 Swagger YAML）

安装

1. 克隆此存储库：

   git clone https://github.com/yourusername/aviation-weather-mcp-server.git
   cd aviation-weather-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 构建服务（此操作将获取最新的 Swagger 定义、生成 API 客户端并编译 TypeScript）：

   npm run build
   

4. 启动服务：

   npm start
   

与 Claude for Desktop 搭配使用

要将此服务与 Claude for Desktop 搭配使用：

1. 编辑 Claude for Desktop 配置文件：

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json

2. 将服务添加到配置中：

   {
     "mcpServers": {
       "aviation-weather": {
         "command": "node",
         "args": [
           "/absolute/path/to/aviation-weather-mcp-server/build/index.js"
         ]
       }
     }
   }
   

3. 重启 Claude for Desktop

示例查询

连接到 Claude 后，你可以提出以下问题：

• “KJFK 当前的天气如何？”
• “KORD 有可用的 TAF 吗？”
• “我计划明天从 KBOS 飞往 KPHL。天气情况怎么样？”
• “KDEN 附近有 PIREP 吗？”

开发

项目结构

• src/index.ts：主服务代码
• packages/aviation-weath-api：用于 Aviation Weather .gov 的 API 客户端自动生成项目

构建航空天气客户端

构建流程如下：

1. npm run aviation-weather-api:clean：删除现有客户端
2. npm run aviation-weather-api:fetch：从 aviationweather.gov 获取最新的 Swagger 定义
3. npm run aviation-weather-api:generate：根据 Swagger 定义生成类型化的 TypeScript 客户端

构建和运行应用

1. npm run build：构建 JavaScript 客户端
2. npm run start：运行 MCP 服务

添加更多工具

要向服务添加新工具，请遵循以下模式：

server.tool(
  "tool-name",
  {
    // Zod schema for parameters
    param1: z.string().describe("Parameter description"),
    param2: z.number().optional().describe("Optional parameter")
  },
  async ({ param1, param2 }) => {
    try {
      // Implementation
      return {
        content: [{
          type: "text",
          text: "Response text"
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `Error: ${error.message}`
        }],
        isError: true
      };
    }
  }
);

工作原理

1. 服务从 aviationweather.gov 获取最新的 Swagger 定义
2. OpenAPI Generator 根据此定义创建类型安全的客户端
3. 服务使用此客户端以正确的类型调用 API
4. 错误处理和响应格式化确保流畅的使用体验

许可证

MIT