返回 MCP 目录
public公开dns本地运行

Amadeus Flight Search

Amadeus MCP服务器整合了航班搜索功能与Claude桌面应用

article

README

🚀 Amadeus MCP 服务器

本 MCP 服务器实现了 Amadeus 的航班搜索功能与 Claude Desktop 的集成,能让你方便地在 Claude Desktop 中使用航班搜索服务。

🚀 快速开始

环境配置

  1. .env 文件所需环境变量
AMADEUS_API_KEY=your_key
AMADEUS_API_SECRET=your_secret
  1. Claude Desktop 配置
{
  "mcpServers": {
    "amadeus": {
      "command": "python",
      "args": ["path/to/amadeus/server.py"],
      "env": {
        "AMADEUS_API_KEY": "your_key",
        "AMADEUS_API_SECRET": "your_secret",
        "PYTHONPATH": "path/to/amadeus"
      }
    }
  }
}

✨ 主要特性

可用工具

搜索航班

参数:

  • origin:IATA 航空港代码
  • destination:IATA 航空港代码
  • date:YYYY - MM - DD 格式

🔧 技术细节

架构说明

  • 使用 FastMCP 作为服务器实现。
  • 实现了标准输入输出传输。
  • 记录到文件和 stderr。
  • 处理异步航班搜索操作。

📚 详细文档

常见问题

连接超时

  • 检查 server.py 日志(位于 amadeus_mcp.log)。
  • 验证环境变量。
  • 检查 Claude Desktop 日志。
  • 参阅 MCP 文档 了解详细信息。

认证错误

  • 验证 Amadeus API 凭据。
  • 检查 .env 文件权限。
  • 确保凭据正确加载。

调试步骤

运行独立测试

npx @modelcontextprotocol/inspector python path/to/server.py

查看日志

tail -f amadeus_mcp.log

验证环境

python -c "import os; print(os.getenv('AMADEUS_API_KEY'))"

📄 支持资源

  1. 模型上下文协议文档
  2. Amadeus API 文档
  3. Claude Desktop MCP 指南
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端