使用说明
项目简介
Amadeus MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它集成了 Amadeus 航班搜索 API,为 LLM 客户端(如 Claude Desktop)提供航班搜索能力。通过此服务器,LLM 可以调用工具查询实时的航班信息,从而扩展其在旅行预订领域的应用能力。
主要功能点
- 航班搜索工具 (search_flights): 允许 LLM 客户端根据出发地、目的地和日期查询航班信息。
- 基于 FastMCP 框架: 使用 FastMCP 库构建,保证了服务器的稳定性和效率。
- 标准 MCP 协议: 遵循 MCP 协议标准,易于与各种 MCP 客户端集成。
- 使用 Amadeus API: 对接 Amadeus 航班数据,提供准确的航班信息。
- 支持 stdio 传输: 使用标准输入输出流进行通信,简化部署和配置。
安装步骤
- 克隆仓库: 首先,您需要从 GitHub 克隆此仓库到本地。
git clone https://github.com/ben4mn/amadeus-mcp.git cd amadeus-mcp - 配置环境变量: 在项目根目录下创建 '.env' 文件,并填入您的 Amadeus API 密钥和密钥:
请替换 'your_amadeus_api_key' 和 'your_amadeus_api_secret' 为您在 Amadeus 开发者平台申请的 API 密钥。AMADEUS_API_KEY=your_amadeus_api_key AMADEUS_API_SECRET=your_amadeus_api_secret - 安装依赖 (可选): 本项目可能依赖 'fastmcp' 和 'amadeus' Python 库。如果运行 'server.py' 时提示缺少模块,请使用 pip 安装:
pip install fastmcp amadeus
服务器配置
要将此 MCP 服务器配置到 MCP 客户端(例如 Claude Desktop),您需要提供服务器的启动命令。以下是配置示例,请根据您的实际 'server.py' 文件路径进行调整。
Claude Desktop 配置 (config.json):
{ "mcpServers": { "amadeus": { "command": "python", "args": ["server.py"] } } }
配置参数说明:
- '"amadeus"': 服务器名称,可以自定义。
- '"command": "python"': 启动服务器的命令,这里使用 Python 解释器。
- '"args": ["server.py"]': 启动命令的参数,指定服务器脚本 'server.py' 的路径。如果 'server.py' 位于当前工作目录,则直接使用 '"server.py"' 即可。
注意: 请确保 MCP 客户端能够找到 'python' 命令以及 'server.py' 文件。您可能需要根据您的环境配置 'PYTHONPATH' 环境变量,或者将 'server.py' 的路径设置为绝对路径。但更推荐的做法是将 '.env' 文件放置在 'server.py' 所在的目录下,并在 Claude Desktop 的配置中,将工作目录设置为 'server.py' 所在的目录。
基本使用方法
- 启动服务器: 当 Claude Desktop 启动并加载配置后,Amadeus MCP Server 将会自动启动。您可以通过查看日志 'amadeus_mcp.log' 或 Claude Desktop 的日志来确认服务器是否成功启动。
- LLM 交互: 在 Claude Desktop 中,您可以向 Claude 发出类似 “搜索从伦敦到巴黎明天的航班” 这样的指令。如果配置正确,Claude 将会调用 Amadeus MCP Server 提供的 'search_flights' 工具来查询航班信息,并将结果返回给您。
信息
分类
网页与API