Traveler.md

Traveler.md MCP サーバー

Traveler.md は、AI アシスタントに旅行者自身の旅の記憶を提供します。旅行者の旅の好みを長期的に記録するプロフィールと、旅行ごとのプランを保存します。データの所有者は旅行者であり、一度アクセスを許可すれば、いつでも取り消せます。

このリポジトリでは、ホスト型 MCP（Model Context Protocol）サーバー https://mcp.traveler.md/mcp について説明しています。サーバーのソースコードはここでは公開されていません。ドキュメント全文は https://docs.traveler.md/mcp にあります。

サーバーの機能

サーバーは2種類のドキュメントを保存し、リクエストに応じて返します。

• traveler.md はプロフィールです。座席の選び方、ホテルのスタイル、予算、食事のスタイル、旅の同行者など、変わりにくい好みを保存します。旅行者ごとに1つです。
• trip.md は1回の旅行に関するドキュメントです。目的地、日程、旅程、予約、メモを保存します。旅行者ごとに複数作成できます。

アシスタントは計画やおすすめを提案する前にこれらを読み取るため、旅行者が同じことを何度も伝える必要はありません。アシスタントは新たに得た情報を書き戻すため、次の会話でも同じ知識を利用できます。

対象範囲は旅行の記憶のみです。サーバーには在庫、価格、空き状況、レコメンドエンジンはありません。おすすめを提案するのはアシスタントです。プロフィールによって、おすすめの基準が変わります。

ツール

ツール	目的
read_profile	プロフィールを返します。名前を指定したセクションで絞り込むこともできます
create_profile	初回利用時にプロフィールを作成します
update_profile	プロフィールの1つ以上のセクションを変更します
list_trips	タイトル、内容、ステータス、日付で旅行をページ分割または検索します
read_trip	1回の旅行に関するドキュメントを返します
create_trip	タイトルとステータスを指定して旅行を作成します
update_trip	旅行のステータス、日付、セクション、日付付きイベントを変更します
archive_trip	旅行をアーカイブします

すべてのドキュメントは、名前付きセクションの集合です。各セクションは短い文のリストです。更新には、直近の読み取りで取得した version_hash が必要です。これにより、2つのアシスタントが同じレコードを書き込んでも、互いの変更が気付かれずに上書きされることはありません。

設定

サーバーはストリーミング可能な HTTP と OAuth 2.1 を使用します。API キーや環境変数はありません。初回利用時にクライアントがブラウザーウィンドウを開きます。旅行者は Traveler.md にサインインして、接続を承認します。

VS Code と GitHub Copilot

ワンクリックで設定できます。

または、ワークスペースの .vscode/mcp.json、あるいはユーザーの mcp.json に次の内容を追加してください。

{
  "servers": {
    "travelermd": {
      "type": "http",
      "url": "https://mcp.traveler.md/mcp"
    }
  }
}

その他のクライアント

claude mcp add --transport http travelermd https://mcp.traveler.md/mcp   # Claude Code
codex mcp add travelermd --url https://mcp.traveler.md/mcp               # Codex

リモート MCP に対応するクライアントなら、URL をそのまま指定できます。

{
  "mcpServers": {
    "travelermd": {
      "url": "https://mcp.traveler.md/mcp"
    }
  }
}

Claude、Cursor、ChatGPT、Gemini など、クライアント別のガイドは https://docs.traveler.md/mcp にあります。

使用方法

接続したら、旅行について自然な言葉で質問してください。アシスタントがツールを呼び出します。

あなたの発言	アシスタントが呼び出すもの
「リスボンではどこに泊まるのがおすすめですか？」	read_profile の後、おすすめを提示
「次の旅行はいつですか？」	開始日順に並べた list_trips
「京都の旅行プランはどうなっていますか？」	list_trips の後、read_trip
「いつも通路側の席がいいです」	update_profile
「旅館を予約しました」	update_trip
「いつかパタゴニアに行ってみたいです」	ステータスを Dreaming にして create_trip

アシスタントは会話の内容だけで旅行について回答し、プロフィールを読み込まないことがよくあります。最初にプロフィールを読み込むよう、アシスタントの指示ファイルに常設の指示を追加してください。

Before you recommend, plan, shortlist or book anything travel-related, call read_profile on the travelermd server. When a specific trip is in play, find it with list_trips and open it with read_trip.

スキルとエージェントプラグイン

このサーバーと、オンボーディング、旅行の聞き取り、旅行の整理、旅行後の振り返りのためのスキルをまとめた Agent Plugin は、https://github.com/TravelAiSolution/traveler-md-agent-plugin にあります。これらのスキルにより、アシスタントはセクション名、文の上限、読み込みを先に行ってから書き込む手順を学習します。

データとプライバシー

すべての記録は旅行者が所有します。アクセス権は OAuth を通じてクライアントごとに付与され、Traveler.md のアカウントページから取り消せます。サーバーは、クレジットカード番号、パスポート番号、既知の旅行者番号、社会保障番号、ドアコードやアクセスコードを拒否します。また、ツールは健康、アクセシビリティ、食事、生体認証に関する詳細を記録しないよう指示されています。プライバシーポリシーは https://traveler.md/privacy にあります。

サポート

サーバーやそのツールに関する質問は、このリポジトリに issue を作成してください。アカウントやセキュリティに関するお問い合わせは、[email protected] までご連絡ください。

ライセンス

この README とリポジトリ内のファイルは、MIT License の下でライセンスされています。ホスト型サーバーは Traveler.md のサービスです。Traveler.md と TravelAI は TravelAI の商標であり、このライセンスはそれらを使用する権利を付与しません。