ALLFLYGHTS

AllFlyghts MCP 服务

用于 AllFlyghts 公共 API 的 TypeScript MCP 服务。

此仓库是一个独立的 Node.js 项目。它通过 MCP 工具提供 AllFlyghts 数据，同时将公共 API 密钥保留在服务端。

通过托管 MCP 服务使用 AllFlyghts

大多数用户无需安装或运行此代码。AllFlyghts 运行着一个托管 MCP 服务。

访问 https://www.allflyghts.com/developers/mcp 了解更多信息。 完整文档：https://www.allflyghts.com/mcp

要使用此服务，请配置 MCP 客户端（Claude Desktop、Cursor 等），使其连接到此端点，并在 Authorization 标头中提供 AllFlyghts API 令牌：

Authorization: Bearer <your-token>

请在 https://www.allflyghts.com/access/sign-in 获取令牌。

此仓库包含该托管服务的源代码，并公开以提高透明度。你也可以根据需要在本地运行——说明如下。

工具

• search_locations
• get_city
• search_flights

要求

• Node.js 20+
• AllFlyghts 公共 API 基础 URL
• AllFlyghts 公共 API 密钥，可通过环境变量直接提供，或通过 Azure Key Vault 提供

环境变量

必需：

• ALLFLYGHTS_PUBLIC_API_BASE_URL

选择一种 API 密钥来源：

• ALLFLYGHTS_PUBLIC_API_KEY
• PUBLIC_API_KEY_VAULT_URL 与 MCP_PUBLIC_API_KEY_SECRET_NAME

可选：

• MCP_AUTH_TOKEN
• MCP_AUTH_TOKEN_SECRET_NAME
• MCP_SERVER_NAME
• MCP_SERVER_VERSION
• MCP_TRANSPORT
• PORT
• MCP_ALLOWED_ORIGINS

如果为 HTTP 模式配置了 MCP_AUTH_TOKEN 或 MCP_AUTH_TOKEN_SECRET_NAME，调用方必须发送：

Authorization: Bearer <token>

安装

npm install

运行

Stdio 模式：

npm run dev:stdio

HTTP 模式：

npm run dev:http

生产构建：

npm run build

然后从 dist/ 启动任一传输方式：

npm run start:stdio
npm run start:http

注意事项

• Streamable HTTP 会为每个请求创建一个全新的 MCP 服务和传输实例。
• 配置 Azure Key Vault 后，密钥会从中解析；如果无法使用，则回退到直接读取环境变量。
• 请勿将真实 API 密钥、身份验证令牌或其他密钥提交到此仓库。