JinDaGe - amadeus-agent MCP Details

article

README

🚀 旅行代理

这是一个简单的概念验证型MCP服务器，专为Amadeus打造，可让基于大语言模型（LLM）的代理将Amadeus用作工具。该服务器为大语言模型提供了直接查询全球实时航班预订信息的工具，具体包括：

特定行程的最便宜机票。
从特定机场出发的所有目的地。
某家航空公司的所有航线。

🚀 快速开始

本项目是一个简单的概念验证型MCP服务器，为大语言模型提供了直接查询全球实时航班预订信息的工具。下面将为你介绍项目的安装、运行等操作。

✨ 主要特性

提供直接查询全球实时航班预订信息的工具。
支持查询特定行程的最便宜机票、特定机场的所有目的地以及某家航空公司的所有航线。

📦 安装指南

本项目依赖于Python的uv项目管理器 uv，它能实现轻松的依赖管理和分发。在安装uv后，你可以创建一个包含所有依赖项的虚拟环境来运行项目。

uv install

source .venv/bin/activate

安装完成后，你需要在项目根目录的.env文件中提供Amadeus开发者凭证。Amadeus开发者页面会告诉你如何获取此类密钥。获取密钥和密码后，将它们按以下方式放入.env文件：

AMADEUS_ENV="test"
AMADEUS_KEY=<YOUR-KEY>
AMADEUS_SECRET=<YOUR-SECRET>

💻 使用示例

基础用法

完成上述安装步骤后，即可开始运行项目。当设置完成后，你可以启动 FastMCP 服务器：

python server.py

此时，服务器就可以接受大语言模型代理的请求了。

高级用法

连接到Claude桌面版

Claude桌面版内置了与MCP服务器交互的支持。要启用此功能，你需要打开Claude桌面版开发者面板，并编辑claude_desktop_config.json以启动服务器。

{
  "mcpServers": {
    "AmadeusServer": {
      "command": "<PATH-TO-PROJECT>/.venv/bin/python",
      "args": [
        "<PATH-TO-PROJECT>/server.py"
      ]
    }
  }
}

然后重启Claude桌面版并开始新的对话。在输入文本之前，从文本输入框下方的配置面板中选择AmadeusServer。

工具面板

此时，Claude应该能够发现你的工具并使用它们来解决你的任务。

📚 详细文档

什么是MCP？

模型上下文协议（Model Context Protocol，MCP）是一种用于大语言模型代理与工具、资源和提示进行交互的客户端 - 服务器协议。你可以将其视为代理的HTTP协议。MCP服务器托管了一系列工具，代理可以使用这些工具为用户执行任务。

什么是Amadeus？

Amadeus是一个全球分销系统（Global distribution system，GDS），本质上是一个被全球大量旅行社使用的预订系统。它允许查询只有旅行社和其他经销商才能直接获取的航班和预订信息。

项目结构

- agent
--- resources   <- 静态数据
--- services    <- 工具逻辑的服务层
--- tools       <- 提供给大语言模型的实际工具
server.py       <- 主服务器端点

amadeus-agent