MCP 服务器

Aviation Weather MCP Server

通过模型上下文协议服务器提供航空气象信息，仅用于信息目的，允许访问METAR、TAF、PIREP和航线天气数据。

README

航空气象 MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，为飞行计划提供航空气象信息。它连接到航空气象 API 以获取 METAR、TAF、PIREP 和其他数据。

免责声明

请勿使用此工具进行飞行计划或飞行中决策。

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

天气数据可能不完整、延迟或不准确。此外，解释此数据的大型语言模型可能会误解或错误地表示关键信息。在任何飞行之前，请务必查阅官方航空气象来源，并从授权提供商处获取适当的气象简报。

此工具未经 FAA 批准，不能替代经过认证的气象服务，仅应作为补充参考。开发人员对基于本工具提供的信息做出的决策不承担任何责任。

始终通过官方渠道验证关键天气信息。

特性

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

设置

前提条件

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

安装

克隆此存储库：

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

安装依赖项：
```
npm install
```
构建服务器（这将获取最新的 Swagger 定义，生成 API 客户端，并编译 TypeScript）：
```
npm run build
```
启动服务器：
```
npm start
```

与 Claude for Desktop 一起使用

要将此服务器与 Claude for Desktop 一起使用：

编辑您的 Claude for Desktop 配置文件：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

将服务器添加到配置中：

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

重启 Claude for Desktop

示例查询

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

"KJFK 的当前天气如何？"
"KORD 是否有 TAF 可用？"
"我计划明天从 KBOS 飞往 KPHL。天气怎么样？"
"KDEN 附近是否有任何 PIREP？"

开发

项目结构

src/index.ts: 主服务器代码
packages/aviation-weath-api: 自动生成 Aviation Weather .gov 的 API 客户端

构建航空气象客户端

构建过程遵循以下步骤：

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

构建和运行应用程序

npm run build: 构建 javascript 客户端
npm run start: 运行 MCP 服务器

添加更多工具

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

server.tool(
  "tool-name",
  {
    // Zod schema for parameters
    param1: z.string().describe("参数描述"),
    param2: z.number().optional().describe("可选参数")
  },
  async ({ param1, param2 }) => {
    try {
      // 实现
      return {
        content: [{
          type: "text",
          text: "响应文本"
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: `错误: ${error.message}`
        }],
        isError: true
      };
    }
  }
);