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)

なぜ？

旅行データは多数のAPIに分散しており、それぞれ認証方法や形式、固有の仕様が異なります。MoltTravelは、これらを単一のModel Context Protocolエンドポイントに集約します。

• 21種類以上のツール：4つの上流MCPプロバイダーと6つの組み込みデータセットから提供
• 静的データは設定不要：空港、航空会社、ビザのデータはAPIキーなしで遅延読み込みされます
• スキーマをそのまま透過するプロキシ：クライアントには実際の上流JSON Schemaが表示され、引数は上流サーバーが検証します
• Claude Desktop、Claude Code、Cursor、その他のMCPクライアントから1行で接続できます

クイックスタート

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 に1行追加して、再起動します。

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. リポジトリをフォークします
2. ブランチを作成します（git checkout -b feature/my-feature）
3. 変更を加えてテストします（python molttravel_server.py）
4. プルリクエストを作成します

ライセンス

MIT