MAQAMI Travel

MAQAMI Travel MCP 服务

MAQAMI 的官方 MCP 服务。MAQAMI 是一个拥有 300 多万家酒店的酒店和机票预订平台。搜索实时酒店房价和航班，查询城市、机场和酒店详情，然后将安全结账链接发送给客户，让他们为所选的具体房型或票价在 book.maqami.co 上预订。远程 Streamable HTTP 端点，无需 API 密钥。

https://mcp.maqami.co/

快速开始

选择你的客户端。每行都足以建立连接；完整步骤请参阅连接。

客户端	最快连接方式
Claude Code	claude mcp add --transport http maqami-travel https://mcp.maqami.co/
Claude Desktop（一键安装）	下载 maqami-travel.mcpb 并打开它（步骤）
任意 stdio 客户端（npm）	将 npx -y maqami-travel 设为服务命令（配置）；Node.js 18+
claude.ai、Claude Desktop 和 Claude mobile	Customize → Connectors → Add custom connector，URL 为 https://mcp.maqami.co/，选择 No sign in。免费套餐也可使用（步骤）
Cursor	添加到 Cursor（一键安装），或将 "maqami-travel": { "url": "https://mcp.maqami.co/" } 添加到 mcp.json
VS Code	在 VS Code 中安装（一键安装），或运行 code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}'
Windsurf	将 "maqami-travel": { "serverUrl": "https://mcp.maqami.co/" } 添加到 mcp_config.json
Gemini CLI	gemini extensions install https://github.com/negm17111995/mcp-server
OpenAI Codex	codex mcp add maqami-travel --url https://mcp.maqami.co/
ChatGPT	开发者模式 → 创建一个 URL 为 https://mcp.maqami.co/ 的应用，并选择 No Authentication（步骤和套餐）
OpenAI Agents SDK	MCPServerStreamableHttp(name="MAQAMI Travel", params={"url": "https://mcp.maqami.co/"})
LangChain	使用 langchain.mcp 中的 MCPAdapter("https://mcp.maqami.co/")（示例）
n8n	MCP Client Tool 节点，端点为 https://mcp.maqami.co/，使用 HTTP Streamable，无需身份验证（步骤）
Cline	MCP Servers → Remote Servers，URL 为 https://mcp.maqami.co/，使用 Streamable HTTP
LM Studio	将 "maqami-travel": { "url": "https://mcp.maqami.co/" } 添加到 mcp.json，或使用安装链接
仅预订技能（Claude Code、Codex、Cursor 及其他支持技能的 Agent）	npx skills add negm17111995/mcp-server
其他客户端	使用 https://mcp.maqami.co/ 上无需身份验证的 Streamable HTTP，或对仅支持 stdio 的客户端使用 npx -y maqami-travel

然后试试：“查找里斯本 5 月 12 日至 15 日适合 2 位成人入住的四星级酒店。”

目录

• 连接
• Agent 如何使用该服务
• 你可以做什么
• 示例提示词
• 常见问题
• 示例
• 隐私与安全
• 开发

连接

服务托管在 https://mcp.maqami.co/，使用 Streamable HTTP 传输。无需安装任何内容，也无需配置 API 密钥。

Claude（claude.ai 和 Claude Desktop）

将 MAQAMI 添加为自定义连接器：

1. 前往 自定义 → 连接器。
2. 点击 + 添加，然后点击 添加自定义连接器。
3. 输入名称 MAQAMI Travel 和 URL https://mcp.maqami.co/，然后点击 继续。
4. 在 身份验证 下，选择 无需登录，然后点击 添加。

所有 Claude 方案均可使用此功能，包括 Free。Free 账户一次只能添加一个自定义连接器。

在 Team 和 Enterprise 方案中，组织所有者需要先在 组织设置 → 连接器 下添加该连接器。

Claude Desktop 扩展

一键安装，适用于 macOS、Windows 和 Linux 上的 Claude Desktop。它不占用自定义连接器名额，因此也适合已使用一个自定义连接器的 Free 账户。

1. 下载 maqami-travel.mcpb。
2. 打开该文件，或将其拖入 Claude Desktop 的 设置 → 扩展。
3. 点击 安装。

该扩展运行与 npm 包相同的 stdio 桥接程序，并连接到 https://mcp.maqami.co/。Claude Desktop 会提供 Node.js，因此无需安装其他内容。

Claude Code

claude mcp add --transport http maqami-travel https://mcp.maqami.co/

或者安装插件，它会添加服务和预订技能，引导 Claude 完成搜索、确认和结账链接生成：

/plugin marketplace add negm17111995/mcp-server
/plugin install maqami-travel@maqami

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "maqami-travel": {
      "url": "https://mcp.maqami.co/"
    }
  }
}

或者一键安装：添加到 Cursor。也可以使用相同的安装深层链接，在浏览器中打开：

cursor://anysphere.cursor-deeplink/mcp/install?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0=

VS Code

添加到工作区中的 .vscode/mcp.json：

{
  "servers": {
    "maqami-travel": {
      "type": "http",
      "url": "https://mcp.maqami.co/"
    }
  }
}

或者一键在 VS Code 中安装，也可以通过命令行将其添加到用户配置文件：

code --add-mcp '{"name":"maqami-travel","type":"http","url":"https://mcp.maqami.co/"}'

Cline

在 Cline 面板中，打开 MCP 服务 → 远程服务，输入 URL https://mcp.maqami.co/，并选择 Streamable HTTP。或者将其添加到 MCP 设置 JSON：

{
  "mcpServers": {
    "maqami-travel": {
      "type": "streamableHttp",
      "url": "https://mcp.maqami.co/"
    }
  }
}

LM Studio

LM Studio 0.3.17 及更高版本支持使用 MCP 服务。在右侧边栏中打开 程序 选项卡，选择 安装 → 编辑 mcp.json，然后添加：

{
  "mcpServers": {
    "maqami-travel": {
      "url": "https://mcp.maqami.co/"
    }
  }
}

或者在浏览器中打开此链接进行安装：

lmstudio://add_mcp?name=maqami-travel&config=eyJ1cmwiOiJodHRwczovL21jcC5tYXFhbWkuY28vIn0%3D

本地模型的上下文窗口较小，因此可以考虑关闭不需要的工具（参见 常见问题）。

Windsurf

在 Cascade 面板的 … 菜单中打开 mcp_config.json（打开 MCP 配置文件），然后添加：

{
  "mcpServers": {
    "maqami-travel": {
      "serverUrl": "https://mcp.maqami.co/"
    }
  }
}

在当前版本中，该文件位于 ~/.config/devin/mcp_config.json（macOS 和 Linux）或 %APPDATA%\devin\mcp_config.json（Windows）。旧版本使用 ~/.codeium/windsurf/mcp_config.json。

ChatGPT

开发者模式应用可在网页端用于 Plus、Pro、Business、Enterprise 和 Education 账户。Free 方案中的 ChatGPT 仅显示应用目录中发布的应用。

1. 打开 设置 → 安全与登录，并启用 开发者模式。
2. 打开 插件，选择 + 按钮，然后创建开发者模式应用。
3. 输入名称 MAQAMI Travel 和 URL https://mcp.maqami.co/，并选择 无需身份验证。
4. 在对话中，从 + 菜单选择 开发者模式，然后选择 MAQAMI Travel。

OpenAI Codex

codex mcp add maqami-travel --url https://mcp.maqami.co/

或者添加到 ~/.codex/config.toml：

[mcp_servers.maqami-travel]
url = "https://mcp.maqami.co/"

Gemini CLI

安装扩展，它会添加服务及其上下文文件：

gemini extensions install https://github.com/negm17111995/mcp-server

或者仅添加服务：

gemini mcp add --transport http maqami-travel https://mcp.maqami.co/

或者添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "maqami-travel": {
      "httpUrl": "https://mcp.maqami.co/"
    }
  }
}

OpenAI Agents SDK（Python）

import asyncio

from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp


async def main() -> None:
    async with MCPServerStreamableHttp(
        name="MAQAMI Travel",
        params={"url": "https://mcp.maqami.co/"},
    ) as maqami:
        agent = Agent(name="Travel assistant", mcp_servers=[maqami])
        result = await Runner.run(agent, "Find 4-star hotels in Lisbon for 2 adults, 12 to 15 May.")
        print(result.final_output)


asyncio.run(main())

LangChain（Python）

LangChain 1.x 在 langchain.mcp 中提供 MCP 支持（测试版）。使用 pip install langchain langchain-openai 安装：

import asyncio

from langchain.agents import create_agent
from langchain.mcp import MCPAdapter


async def main() -> None:
    async with MCPAdapter("https://mcp.maqami.co/") as maqami:
        tools = await maqami.list_tools()
        agent = create_agent("openai:gpt-5.4-mini", tools)
        result = await agent.ainvoke(
            {"messages": [{"role": "user", "content": "Which airports serve Tokyo?"}]}
        )
        print(result["messages"][-1].content)


asyncio.run(main())

如需查看在任何预订操作前都会征求你批准的版本，请参阅 travel-agent-examples/langchain-python。

n8n

1. 在工作流中添加一个 AI Agent 节点。
2. 在 Tools 下添加一个 MCP Client Tool 节点。
3. 将端点设置为 https://mcp.maqami.co/，选择 HTTP Streamable 作为服务端传输方式（如果你的 n8n 版本显示此选项），并将身份验证设为 None。
4. 在 Tools to Include 下，选择工作流所需的工具，或保留 All。

其他 Streamable HTTP 客户端

设置	值
URL	https://mcp.maqami.co/
传输方式	Streamable HTTP
身份验证	None

本地 stdio（npm）

对于仅支持 stdio 服务的客户端，maqami-travel npm 包是连接远程端点的轻量桥接程序。它不会在本地运行预订逻辑，也不需要凭据。需要 Node.js 18 或更高版本。

{
  "mcpServers": {
    "maqami-travel": {
      "command": "npx",
      "args": ["-y", "maqami-travel"]
    }
  }
}

这适用于 claude_desktop_config.json 以及任何其他可启动 stdio 服务的客户端。

Agent 如何使用该服务

该服务是一个标准 MCP 服务。每个工具都有用于输入的 JSON Schema 和 MCP 注解，因此客户端可以区分只读工具（readOnlyHint: true）与会产生更改的工具。

客户始终在 MAQAMI 网站 book.maqami.co 上预订并付款。该服务会查找酒店或航班、保留价格，并返回对应选项的 checkoutUrl；客户在该网站填写住客或乘客信息、付款并获取确认信息。没有任何工具会收款或索要付款信息。

酒店预订流程

步骤	操作	工具（示例）
1. 搜索房价	查询指定日期和住客人数的实时房价。需要 checkin、checkout、occupancies、currency、guestNationality，以及一个地点字段（cityName 配合 countryCode、latitude 和 longitude，或 iataCode、hotelIds 或 aiSearch）。若要按名称查找酒店，请使用 hotelName 和 countryCode 调用 get_data_hotels，然后通过 hotelIds 搜索。每个房价都有一个 offerId。	post_hotels_rates
2. 查看详情	查看用户感兴趣酒店的描述、设施、照片和评论	get_data_hotel、get_data_reviews
3. 确认	向用户展示酒店、房间、日期、住客、价格和取消条款，并等待用户明确同意	（你的 Agent）
4. 预订	保留一个 offerId（须原样传入搜索结果中的值），并返回一个 prebookId，其中包含最终价格、取消条款和 checkoutUrl	post_rates_prebook
5. 结账	将 checkoutUrl（https://book.maqami.co/booking?prebookId=...）提供给客户，以便其填写住客信息并付款	（你的 Agent）

航班预订流程

步骤	操作	工具（示例）
1. 查找机场	将城市解析为 IATA 机场代码	get_data_flights_airports
2. 搜索航班	查询实时报价。需要 legs（每项包含 origin、destination 和 date）、adults 和 currency。单程需要一段行程，往返需要两段。还会返回 searchUrl，即 book.maqami.co 上的相同搜索结果。	post_flights_rates
3. 核实	确认 offerId 仍然有效，并返回该报价的最新价格、行李额度、票价规则和 checkoutUrl。报价会过期（参见 expiration）；如果报价已失效，请重新搜索。	post_flights_verify
4. 确认	向用户展示航班、乘客、最终价格和票价规则，并等待用户明确同意	（你的 Agent）
5. 结账	尽快将 checkoutUrl（https://book.maqami.co/flights/booking?offerId=...）提供给客户；票价仅在有限时间内保留	（你的 Agent）

现有预订

查询、修改和取消工具需要预订 ID 和预订时使用的电子邮箱；只有两者都匹配时，服务才会返回或更改预订。每次调用预订工具时，都要传入 bookingId 和 email。要查找客户的酒店预订，请使用预订时填写的电子邮箱和姓氏调用 listBookings；它只会返回预订人信息两者都匹配的预订。酒店预订使用 cancel_hotel_booking 取消，航班使用 post_flights_bookings_bookingid_cancellations 取消（请先调用 get_flights_bookings_bookingid_cancellations 查看退款估算）。put_bookings_bookingid_amend 可更正酒店预订中预订人的姓名、电子邮箱或电话：该工具需要提供预订当前记录的 email，以及更正后的 holder（包含 firstName、lastName、email 和可选的 phone）。

以上工具名称和必填字段是服务于 2026 年 10 月发布的。客户端从服务收到的工具列表始终是唯一依据：列表中列出的才是可用工具，其他工具名称都会被拒绝。酒店 offerId 由服务签名：请按原样传入；如果被拒绝，请重新搜索。

Agent 的良好实践

• 询问缺少的信息，不要猜测：酒店需要日期、客人数、客人国籍和币种；航班需要日期、乘客信息和币种。
• 只引用工具返回的信息。 展示价格及其币种，并在有取消规则或票价规则时一并说明。
• 执行任何非只读操作前都要确认。 预订前确认会锁定实际价格，修改和取消工具会更改或取消真实预订。先询问用户，并准确说明将要执行的操作。
• 只发送工具返回的链接。 向客户提供预订前确认或验证工具返回的 checkoutUrl，绝不要在聊天中索取银行卡或护照信息。
• 如果预订前确认或验证时价格或可订情况发生变化，请展示新结果并再次询问用户。
• 仅收集预订所需的客人信息，并且只有在用户选定选项后才发送这些信息。
• 尽量简短地回复。 设置酒店搜索的 limit 和 maxRatesPerHotel，以及航班搜索的 filters。get_data_facilities、get_data_chains、get_data_iatacodes 和 get_data_cities 会返回完整的参考列表，因此只有在需要从中获取 ID 时才调用；查找机场请改用 get_data_flights_airports。

示例展示了一种实现方式：只读工具会自动运行，其他所有工具都会等待用户批准。

常见问题

连接时需要 API 密钥或账户吗？ 不需要。此端点接受连接，无需身份验证。

客户如何付款？ 只能通过 MAQAMI 网站付款。预订酒店或验证航班后，系统会返回一个 checkoutUrl，指向 book.maqami.co 上对应的房间或票价。客户打开链接，填写住客或乘客信息，安全付款，并在该页面收到确认信息。MCP 服务不会收取款项。

结账链接会创建真实预订吗？ 会，客户在 book.maqami.co 完成结账后，预订即生效。付款前请核对详情和最终价格。

服务使用哪种传输方式？ 使用 https://mcp.maqami.co/ 上的 Streamable HTTP。如果你的客户端仅支持 stdio，请使用 maqami-travel npm bridge。

客户端提示工具太多时，我该怎么办？ 只启用你需要的工具。大多数客户端都支持此操作：VS Code 中的工具选择器、Cursor 和 Claude 中的单工具开关，以及 n8n 中的 Tools to Include。对于旅行助手，以上表格中的搜索、详情、预订和验证工具是不错的起点。

服务能看到什么？ MCP 服务只会收到客户端发送的工具调用及其参数。它看不到对话的其他内容。

该服务列在哪些平台上？ 它列在官方 MCP Registry 中，名称为 io.github.negm17111995/maqami-travel，也列在 npm 上，名称为 maqami-travel。它还是 Claude Desktop 扩展（maqami-travel.mcpb）。此代码库也是 Gemini CLI 扩展（gemini-extension.json）、Claude Code 插件和市场（.claude-plugin/）、Codex 插件（.codex-plugin/plugin.json）以及 Agent Plugins 软件包（plugin.json 和 mcp.json）。这些插件打包了 maqami-travel-booking 技能。目录包括：Smithery、Glama、Raycast 的 MCP 注册表、ToolSDK MCP 注册表和 Hermes Agent 插件目录。

我可以在自己的 Agent 或产品中使用它吗？ 可以，它是一个公共端点。请遵循上述确认指引。如需合作，请联系 [email protected]。

如何报告错误或安全问题？ 请为错误和客户端设置问题提交 issue。如有安全问题，请遵循 SECURITY.md，不要公开提交 issue。

示例

negm17111995/travel-agent-examples 提供了简洁、可运行的旅行助手示例，可通过 OpenAI Agents SDK（Python）、搭配 LangGraph 的 LangChain（Python）以及 Vercel AI SDK（TypeScript）连接到此服务。每个示例都会在执行任何非只读调用前征求你的批准。

你可以做什么

• 搜索酒店，查看实时价格和空房情况。
• 搜索航班并比较票价。
• 查询城市、机场和酒店详情，包括设施和照片。
• 锁定价格：预订酒店房间或验证航班票价。
• 发送结账链接，链接指向 book.maqami.co，客户可在此填写信息、付款并获得确认。
• 查找、查询和取消现有预订：使用电子邮件和姓氏查找预订，然后使用预订 ID 和电子邮件对其进行操作。

示例提示词

• “查找伊斯坦布尔的 5 星级酒店，入住日期为 8 月 15 日至 17 日，2 位成人。”
• “向我展示第二家酒店的设施和照片。”
• “搜索 12 月 10 日从迪拜飞往伦敦、1 位成人的航班。”
• “哪些机场为东京提供服务？”
• “锁定那个房间，并把结账链接发给我。”

隐私与安全

• 连接无需 API 密钥或账户。
• 所有发往 https://mcp.maqami.co/ 的流量均通过 HTTPS 加密。
• 搜索和预订由 MAQAMI 处理。付款仅在 book.maqami.co 上进行；MCP 服务不会接收银行卡信息。
• 完成结账会创建真实预订。付款前请核对详情和最终价格。
• 隐私政策：maqami.co/privacy-policy

开发

此仓库包含 npm stdio 桥接程序（index.js）。托管服务单独部署。

npm install
npm test

桥接程序测试会启动本地模拟 Streamable HTTP 服务，并通过 MAQAMI_MCP_URL 环境变量将桥接程序指向该服务。此变量仅用于测试；默认情况下，桥接程序会连接到 https://mcp.maqami.co/。清单测试会检查每个清单能否解析、是否指向同一端点，以及是否包含 package.json 中的版本号。

仓库布局

文件	用途
index.js	连接到托管端点的 npm stdio 桥接程序
server.json	官方 MCP Registry 条目
gemini-extension.json, GEMINI.md	Gemini CLI 扩展及其上下文文件
.claude-plugin/plugin.json, .mcp.json	Claude Code 插件
.claude-plugin/marketplace.json	Claude Code 插件市场（maqami）
.codex-plugin/plugin.json, assets/logo-512.png	Codex 插件及其图标
plugin.json, mcp.json	Agent Plugins 清单
mcpb/manifest.json, scripts/build-mcpb.sh	Claude Desktop 扩展（npm run build:mcpb 会生成 dist/maqami-travel.mcpb）
skills/maqami-travel-booking/SKILL.md	随插件打包的预订技能
glama.json	Glama 目录元数据
AGENTS.md, llms.txt	面向编码 Agent 和 LLM 工具的简要指南
test/	针对本地模拟服务的桥接程序测试，以及清单一致性检查（npm test）
.github/workflows/	CI（每次拉取请求都会运行 npm test）以及向 npm 和 Official MCP Registry 发布的发布工作流

贡献

欢迎提交文档修正、客户端设置指南和错误报告。请参阅 CONTRIBUTING.md 和行为准则。如有问题或想法，请前往 Discussions。

许可证

MIT

支持

如有问题或遇到故障，请联系 [email protected] 或提交问题。

关于 MAQAMI

MAQAMI（MAQAMI LLC）是一家在美国注册的旅游公司，在全球销售酒店和机票：拥有超过 300 万处房源、即时确认、安全的 Stripe 结账服务和全天候支持。

• 网站： maqami.co
• 预订酒店和机票： book.maqami.co
• 此 MCP 服务（设置指南）： maqami.co/mcp