FlightAware MCP Server

FlightAware MCP 服务

用于将模型上下文协议（MCP）客户端连接到 FlightAware 的 AeroAPI，以获取实时航空数据的桥接服务。

功能

• 航班信息：获取特定航班的实时信息
• 机场运营：跟踪机场的到达和出发航班
• 飞机详情：通过尾号检索飞机信息
• 机场搜索：按地区、国家或自定义查询查找机场
• 详细跟踪：获取全面的航班运营详情
• 灵活的协议支持：支持 TCP 和 WebSocket 连接
• 轻松配置：通过环境变量或命令行简单设置

MCP 工具

此服务通过 MCP 接口提供以下工具：

getFlightByIdent

使用航班标识符获取特定航班的信息。

{
  "id": "req123",
  "method": "getFlightByIdent",
  "params": {
    "ident": "AAL100"
  }
}

getFlightsForAirport

列出在特定机场到达或出发的航班。

{
  "id": "req124",
  "method": "getFlightsForAirport",
  "params": {
    "airport_code": "KJFK",
    "arrivals": true,
    "departures": true,
    "type": "all"
  }
}

getAircraftByTail

通过尾号获取特定飞机的信息。

{
  "id": "req125",
  "method": "getAircraftByTail",
  "params": {
    "tail": "N12345"
  }
}

getAirportsByRegion

按国家、地区或自定义查询搜索机场。

{
  "id": "req126",
  "method": "getAirportsByRegion",
  "params": {
    "country": "US",
    "region": "CA",
    "query": "international"
  }
}

getFlightDetails

获取特定航班的详细信息。

{
  "id": "req127",
  "method": "getFlightDetails",
  "params": {
    "ident": "AAL100"
  }
}

配置

AeroAPI 密钥

使用此服务需要 FlightAware AeroAPI 密钥。

• 在 FlightAware AeroAPI 注册
• 按照其说明获取 API 密钥

安装

使用 NPX（无需安装）

使用 npx 直接运行：

npx flightaware-mcp --port 8080 --aeroapi-key YOUR_API_KEY

全局安装

全局安装后可从任意位置运行：

npm install -g flightaware-mcp
flightaware-mcp --port 8080 --aeroapi-key YOUR_API_KEY

本地安装

在项目中本地安装：

npm install flightaware-mcp

然后添加到你的 package.json 脚本中：

"scripts": {
  "start-mcp": "flightaware-mcp --port 8080"
}

命令行选项

Usage: flightaware-mcp [options]

Options:
  -V, --version               output the version number
  -p, --port <number>         Port to listen on (default: "8080")
  -k, --aeroapi-key <string>  FlightAware AeroAPI key
  -m, --mode <string>         Server mode (tcp or ws) (default: "tcp")
  -t, --timeout <number>      Request timeout in milliseconds (default: "30000")
  -d, --debug                 Enable debug mode with verbose logging
  -h, --help                  display help for command

Notes:
  - If you experience timeout errors (MCP error -32001), try increasing the timeout value.
  - Debug mode will provide detailed logs about requests and timeouts.
  - For n8n integrations, set a higher timeout value (60000 or more) if needed.

环境变量

你可以使用环境变量代替命令行参数：

AEROAPI_KEY=your_api_key
MCP_SERVER_PORT=8080
MCP_SERVER_MODE=tcp  # or ws for WebSocket
MCP_REQUEST_TIMEOUT=60000  # timeout in milliseconds, increase if experiencing timeouts
DEBUG=true  # enable debug mode with verbose logging
LOG_LEVEL=info  # log level (error, warn, info, debug)

使用示例

MCP 客户端配置

对于支持服务配置的 MCP 客户端，可以使用以下配置：

{
  "mcpServers": {
    "flightaware": {
      "command": "npx",
      "args": [
        "-y",
        "flightaware-mcp"
      ],
      "env": {
        "AEROAPI_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

MCP 客户端代码示例

const net = require('net');

const client = new net.Socket();
client.connect(8080, '127.0.0.1', () => {
  console.log('Connected to MCP server');
  
  // Request flight information
  const request = {
    id: 'req1',
    method: 'getFlightByIdent',
    params: {
      ident: 'UAL123'
    }
  };
  
  client.write(JSON.stringify(request) + '\n');
});

client.on('data', (data) => {
  const response = JSON.parse(data.toString().trim());
  console.log('Received response:', response);
  client.end();
});

client.on('close', () => {
  console.log('Connection closed');
});

使用内置客户端进行测试

此软件包包含一个便于测试的测试客户端：

# First, start the server
npm start

# In another terminal, run the test client
npm run client

开发

从源代码构建

# Clone the repository
git clone <repository-url>
cd flightaware-mcp

# Install dependencies
npm install

# Start development server
npm start

运行测试

npm test

代码检查

npm run lint

故障排除

超时错误

如果遇到超时错误（MCP error -32001: Request timed out），请尝试以下解决方案：

1. 增加超时时间：

   # With command line
   flightaware-mcp --timeout 60000
   
   # With environment variables
   MCP_REQUEST_TIMEOUT=60000 flightaware-mcp
   

2. 启用调试模式以获取更多信息：

   flightaware-mcp --debug
   

3. 检查网络连接：

   • 确保服务具有稳定的互联网连接
   • 检查是否有防火墙规则阻止出站请求

4. 对于 n8n 集成：

   • 设置更长的超时时间（60000ms 或更长）
   • 确保 MCP 服务和 n8n 可以正常通信
   • 尝试 TCP 和 WebSocket 模式（--mode ws 或 --mode tcp）

5. 检查 AeroAPI 速率限制：

   • FlightAware AeroAPI 的速率限制取决于你的订阅
   • 启用调试模式以查看详细的 API 响应信息

许可证

MIT