MolTravel

  Kiwi.com    Navifare     Peek.com    LastMinute
  (flights)   (prices)   (experiences)  (flights)
      \          |           |          /
       \         |           |         /
        +--------+-----------+--------+
        |                             |
        |    MoltTravel MCP Server    |
        |                             |
        |  Airports  Airlines  Visas  |
        |  Countries  FCDO  Gemini AI |
        |                             |
        +-------------|---------------+
                      |
               MCP over HTTP
                      |
              Any MCP Client
        (Claude, Cursor, your app)

为什么选择 MoltTravel？

旅行数据分散在数十个 API 中，每个 API 都有自己的身份验证方式、格式和特性。MoltTravel 将它们整合到一个模型上下文协议端点后：

• 21+ 个工具，来自 4 个上游 MCP 提供方和 6 个内置数据集
• 静态数据无需配置——机场、航空公司和签证数据会在需要时加载，无需 API 密钥
• 架构透明的代理——客户端可以看到真实的上游 JSON Schema；上游服务会验证自己的参数
• 只需一行即可连接 Claude Desktop、Claude Code、Cursor 或任何 MCP 客户端

快速开始

git clone https://github.com/navifare/moltravel-mcp.git
cd moltravel-mcp
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python molttravel_server.py

服务会在 http://localhost:8000/mcp 启动。就是这么简单。

连接客户端

{
  "mcpServers": {
    "molttravel": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

{
  "mcpServers": {
    "molttravel": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async with streamablehttp_client("http://localhost:8000/mcp") as (r, w, _):
    async with ClientSession(r, w) as session:
        await session.initialize()
        tools = await session.list_tools()
        result = await session.call_tool("airports_lookup", {"code": "ZRH"})

工具

航班与价格

体验与活动

参考数据 _{（内置，无需 API 密钥）}

自然语言 _（可选）

需要 GEMINI_API_KEY。示例：“下周从苏黎世飞往罗马的最便宜航班是什么？我需要签证吗？”

1. 工具发现

启动时，MoltTravel 会连接到每个上游 MCP 服务，调用 tools/list，并使用 {provider}_{tool_name} 前缀注册发现的每个工具：

kiwi       → kiwi_search-flight, kiwi_feedback-to-devs
navifare   → navifare_flight_pricecheck, navifare_format_flight_pricecheck_request
peek       → peek_search_experiences, peek_experience_details, ...
lastminute → (discovered at runtime)

原生工具（机场、航空公司、签证、国家、FCDO）会直接注册。

2. 架构透明的代理

客户端看到的是每个工具的原始上游 JSON Schema，包括枚举、嵌套对象、$ref 等所有内容。内部，MoltTravel 使用宽松的 Pydantic 模型（所有字段均为 Any），使参数无需经过有损验证即可传递。上游 MCP 服务会验证自身的参数。

# Client sees the real schema
parameters = input_schema          # original from upstream

# Server doesn't re-validate types — just passes through
fields[prop_name] = (Any, Field(default=None))

3. 延迟加载数据

静态数据集（机场、航空公司、签证）会在首次使用时通过异步锁下载。不会增加启动开销；如果你只使用航班工具，也不会浪费带宽。

配置

部署

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["python", "molttravel_server.py"]

docker build -t molttravel .
docker run -p 8000:8000 molttravel

项目结构

moltravel-mcp/
├── molttravel_server.py        # Server core — proxy logic, native tools, routing
├── requirements.txt            # mcp[cli], httpx
├── test_search.py              # Integration test client
└── providers/
    ├── __init__.py             # MCP_PROVIDERS registry + exports
    ├── mcp_client.py           # Generic HTTP client for upstream MCP servers
    ├── data_loader.py          # CSV downloader + haversine distance
    ├── airports.py             # 45K airports from OurAirports
    ├── airlines.py             # 7K airlines from OpenFlights
    ├── visas.py                # Visa requirements from Passport Index
    ├── restcountries.py        # REST Countries API
    ├── fcdo.py                 # UK FCDO travel advisories
    └── gemini.py               # Gemini Flash tool router

扩展

添加 MCP 提供方

在 providers/__init__.py 中添加一行，然后重启：

MCP_PROVIDERS = {
    "kiwi": McpClient("https://mcp.kiwi.com/mcp"),
    "navifare": McpClient("https://mcp.navifare.com/mcp"),
    "peek": McpClient("https://mcp.peek.com/mcp"),
    "your_provider": McpClient("https://mcp.example.com/mcp"),  # new
}

工具会自动发现并注册为 your_provider_{tool_name}。

添加原生工具

@server.tool(name="my_tool")
async def my_tool(query: str) -> str:
    """Description shown to MCP clients."""
    return "result"

数据来源与许可证

贡献

1. Fork 此仓库
2. 创建分支（git checkout -b feature/my-feature）
3. 修改并测试（python molttravel_server.py）
4. 发起拉取请求

许可证

MIT