travel.art

mcp/

travel.art の Model Context Protocol サーバーです。https://mcp.travel.art/ で稼働しています。

できること

Model Context Protocol（Streamable HTTP トランスポート、リクエスト／レスポンスモード）を介して、travel.art のアートツーリズムデータを AI エージェントに公開します。

v1 では、次の 3 つのツールを提供します。

• find_art_events — ビエンナーレ、アートフェア、フェスティバルの開催日、会場、チケット情報、概要、詳細ガイドへのリンク
• find_museum_guide — 主要美術館（Louvre、Vatican、Uffizi）の2026年のチケット情報、開館時間、必見作品
• recommend_art_trip — 公開済みの travel.art コンテンツのみを使った、都市別の旅程

カタログ v1.6.0：イベント 23 件、美術館 12 件、乗り継ぎ旅程 6 件（公開カレンダーと主要記事から同期。イベント情報は2026-09-14に再確認済み）。

技術スタック

mcp/
  src/
    index.ts        # Worker entry, MCP HTTP protocol (JSON-RPC 2.0)
    tools.ts        # Tool definitions + handlers
    data.ts         # Static dataset (typed)
  scripts/          # (Future) sync from content/<slug>/index.md frontmatter
  data/             # (Future) sync output
  package.json
  wrangler.toml
  tsconfig.json

• ランタイム： Cloudflare Workers、無料枠（1日あたり100kリクエスト）
• 言語： TypeScript
• トランスポート： MCP Streamable HTTP（リクエスト／レスポンス、SSE なし — 単発のツール呼び出し）
• プロトコルバージョン： 2025-03-26
• 認証： なし（公開読み取り専用）

利用方法

ヘルスチェック

curl https://mcp.travel.art/health

初期化ハンドシェイク

curl -X POST https://mcp.travel.art/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-client","version":"0.1"}}}'

ツールの一覧表示

curl -X POST https://mcp.travel.art/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

ツールの呼び出し

curl -X POST https://mcp.travel.art/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"find_art_events","arguments":{"country":"IT"}}}'

Claude Desktop の設定

macOS の場合、~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

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

デプロイ

cd mcp
npm install
npx wrangler deploy

（環境変数に CLOUDFLARE_API_TOKEN と CLOUDFLARE_ACCOUNT_ID を設定するか、wrangler login が必要です。）

Worker は Cloudflare API を介してカスタムドメイン mcp.travel.art にバインドされています（初回のみの設定。DECISIONS.md 2026-05-08 を参照）。

今後の予定（v2 バックログ）

• ビルド時のデータ抽出 — 手動で管理している data.ts を、content/<slug>/index.md のフロントマターを読み取る同期スクリプトに置き換えます（イベントは Event 型スキーマ、美術館は Place 型スキーマから取得）。新しい主要記事が自動的に MCP に反映されます。
• ツールの追加 — find_artist_residencies、find_collateral_events、today_in_art_tourism（カタログ全体を対象に、今日営業している施設を調べるカレンダー）。
• 認証ティア — 現在は公開読み取り専用です。商用クライアントが大量のプログラムアクセスを希望する場合は、Account API Tokens の下に API キーのティアを追加します。
• ストリーミングレスポンス — 長い旅程のおすすめには SSE に切り替えます。
• レート制限 — IP ごとのスロットリングを導入します（現在は Cloudflare 独自の DDoS 保護に依存しています）。
• スキーマのバージョン管理 — 互換性を破る変更を行う場合は、mcp.travel.art/v1、/v2 のように URL をバージョン分けします。

エージェントの運用仕様については、.claude/agents/mcp-architect.md を参照してください。