Airlabs Mcp Server

AirLabs MCP 服务

此 Model Context Protocol (MCP) 服务可访问 AirLabs 航空数据 API。它让 Claude Desktop 和 Cursor 等 AI 助手能够通过自然语言提问，直接访问实时航班数据、机场时刻表、延误信息，以及航空公司、机场、机队和航线的参考数据库。

整个服务都在单个文件（index.ts）中：工具定义、AirLabs HTTP 客户端、请求处理和 stdio 传输。

功能

• 实时航班状态 — 按航班号查询任意航班，并获取状态、登机口、航站楼和延误信息。
• 机场时刻表 — 查询任意机场的出发和到达信息。
• 延误监控 — 查找机场或航空公司延误超过指定阈值的航班。
• 实时位置 — 按区域、航空公司或注册号查询飞机的实时坐标、高度、速度和航向。
• 最近机场 — 查找距任意坐标最近的机场。
• 参考数据库 — 查询航空公司、机场、机队（按机尾号或 ICAO24 十六进制代码）和航线网络。
• 代码解析 — 将地点或航空公司名称转换为 IATA/ICAO 代码。

前提条件

1. Node.js 18.0.0 或更高版本。
2. AirLabs API 密钥 — 在 https://airlabs.co/signup 免费获取密钥。

安装

通过 npm 安装

npm install -g @airlabs-co/airlabs-mcp

配置

集成 Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "airlabs": {
      "command": "npx",
      "args": ["@airlabs-co/airlabs-mcp@latest"],
      "env": {
        "AIRLABS_API_KEY": "your_api_key_here"
      }
    }
  }
}

注意：

• 将 your_api_key_here 替换为你的 AirLabs API 密钥。
• 编辑配置后重启 Claude Desktop。
• 如果在本地从源代码构建，请使用 "command": "node", "args": ["/path/to/build/index.js"]。

其他 MCP 客户端

通过 stdio 直接运行服务：

AIRLABS_API_KEY=your_api_key_here npx @airlabs/airlabs-mcp

可用工具

工具	AirLabs 端点	用途
get_flight_status	/flight	按 IATA/ICAO 航班号查询单个航班的实时状态
get_airport_schedule	/schedules	查询机场的出发 / 到达信息
monitor_delays	/delays	查找延误超过指定阈值的航班
track_live_flights	/flights	按区域、航空公司或注册号查询飞机的实时位置
find_nearest_airport	/nearby	查找距某坐标最近的机场
search_airport_code	/suggest	将名称解析为 IATA/ICAO 代码
get_airline_info	/airlines	按代码查询航空公司详情
get_airport_info	/airports	按代码查询机场详情
lookup_aircraft	/fleets	按注册号或 ICAO24 十六进制代码查询飞机
find_routes	/routes	查询哪些航空公司运营指定航线

所有工具都接受可选的 _fields 参数（端点支持时），仅返回选定字段以精简响应。

使用示例

配置完成后，只需向助手提问：

• “BA117 航班准点吗？” → get_flight_status
• “今天有哪些航班从 JFK 起飞？” → get_airport_schedule
• “LAX 的到达航班是否延误超过 30 分钟？” → monitor_delays
• “显示飞越纽约的飞机。” → track_live_flights
• “注册号为 N790AN 的飞机是什么机型？” → lookup_aircraft
• “有哪些航空公司运营伦敦至东京的航线？” → find_routes

开发

从源代码构建

git clone https://github.com/airlabs-co/airlabs-mcp.git
cd airlabs-mcp
npm install
npm run build

贡献

1. Fork 此仓库。
2. 创建功能分支。
3. 进行更改。
4. 提交拉取请求。

支持

• 文档：https://airlabs.co/docs
• 问题反馈：GitHub Issues
• API 支持：https://airlabs.co/faq#Contact

许可证

MIT 许可证 — 参见 LICENSE。