wanderlog-mcp

Claude（またはMCP互換のエージェント）が会話を通じてWanderlogの旅行プランを作成・閲覧できるようにするMCPサーバーです。

WanderlogのUIをクリックして旅行を計画する代わりに、次のように尋ねるだけです：

「14日間の日本ゴールデンルート旅行を作成して — 東京、箱根、京都、奈良、大阪。」

エージェントがツールを呼び出し、各日の場所とメモを交互に配置し、ホテルのブロック、フェリー、バス、電車、レンタカー、チェックリストを追加して、数分で完全に埋められたWanderlogの旅行プランが完成します。

実際の例を見る： 14日間の日本ゴールデンルート — このMCPサーバーを使用してAIエージェントが完全に構築しました。

新機能（未リリース）

• wanderlog_search_hotels — airbnb、expedia、google、kayakにわたるWanderlogのホテルアグリゲーターを検索します。ベンダーごとの価格比較とファセットフィルターの発見を含むランク付けされたオファーを返すため、LLMがWanderlogの内部enum値を覚える必要はありません。

• 起動時の認証プローブが失敗した場合、最初のツール呼び出しで共有リトライが1回行われ、有効なセッションが一時的なネットワークまたはプロキシエラーからサーバーを再起動せずに回復できるようになります。

Related MCP server: kyoto-assistant-mcp

v0.3.1の新機能

• Wanderlogは急速な編集をレート制限します — バースト的な変更（LLMが完全な旅程を構築する場合）は、不透明な「Submit op timeout」で失敗する代わりに、バックオフ付きで自動的にリトライされるようになりました。

• リトライできないレート制限の拒否は、10秒のハングではなく明確なエラーとして表示されます。

• wanderlog_update_trip_datesによって作成された新しい日のセクションは、Wanderlogのネイティブなセクション形状と正確に一致するようになりました。

v0.3.0の新機能

• wanderlog_search_guides + wanderlog_get_guide — ユーザーが書いたWanderlogの旅行ガイドを発見して読むことができます。LLMは「ベトナムのガイドは何がある？」と尋ねて、インスピレーションとして完全な旅程を取得できます。

• wanderlog_remove_note — 自然言語の参照でスタンドアロンのメモブロックを削除します。

• wanderlog_edit_note — メモブロック、場所の注釈、チェックリストのタイトル/項目にわたって検索と置換を行います。

• 詳細モードでは、場所のメモやメモブロックが切り詰められなくなりました — ガイドと旅程は完全なコメントを表示します。

• 修正：埋め込みを含むメモが[object Object]として表示されなくなりました。場所の参照はハイフン/ダッシュの違いをまたいで一致するようになりました（例："Roppongi Hills - Tokyo City View"）。

v0.2.0の新機能

• wanderlog_rename_day — 自動生成された日の見出し（例："Barcelona"）を説明的なもの（"Arrival — Feria de Abril"）に置き換えます。""を渡すとデフォルトにリセットされます。

• ツール表にwanderlog_annotate_placeとwanderlog_add_expenseが記載されるようになりました（以前にリリース済みですが、v0.1.0のドキュメントにはありませんでした）。

v0.1.0の新機能

• 完全な旅程の構築：1回の会話で場所、メモ、ホテル、チェックリスト

• wanderlog_search_places — Wanderlogの場所データベースを使用して、任意の目的地の近くの実際の場所を検索

• wanderlog_add_note — 場所の間に交通のヒント、予約情報、現地のアドバイスを挿入

• wanderlog_add_checklist — 旅行前および日ごとのチェックリスト（ビザ、通貨、時間指定入場チケット）

• 起動時にMCPサーバーの指示が注入され、Claudeが自動的に完全な旅程を構築

• 起動時の認証プローブ — 会話の途中で失敗する代わりに、期限切れのクッキーを即座に検出

プロンプトの例

"What trips do I have in Wanderlog?"

"Create a 7-day itinerary for Lisbon starting June 1 — include restaurants, day trips,
and a hotel near the waterfront."

"Add a day trip to Sintra on day 3 of my Lisbon trip."

"I'm spending 5 days in Tokyo — build me a full itinerary with museum visits, ramen spots,
and a ryokan in Shinjuku."

"Look at my Barcelona trip and add practical notes for getting between each place."

"Add a pre-trip checklist to my Paris trip — visa, currency, offline maps, travel insurance."

"Move my Rome trip back by two weeks."

"Give me the shareable link to my Kyoto itinerary."

"Remove the Colosseum from day 2 of my Rome trip."

ツール

前提条件

• Node.js 22以降

• Wanderlogアカウント

• MCP互換クライアント：Claude Code、Claude Desktop、OpenAI Codex、Cursor、VS Code、または任意のstdio MCPホスト

セットアップ

ステップ1 — Wanderlogのセッションクッキーを取得

Wanderlogには公開APIがないため、wanderlog-mcpはブラウザのセッションクッキー（connect.sid）を使用して認証します。有効期間は約1年で、あなたのマシンから離れることはありません。

パスワードと同じように扱ってください — Wanderlog UIで持っているのと同じアクセス権を付与します。

Chrome / Edge

1. wanderlog.comにアクセスしてログインします

2. F12を押してDevToolsを開きます

3. Applicationタブをクリックします

4. 左側のサイドバーで**Storage → Cookies → https://wanderlog.com**を展開します

5. Nameがconnect.sidの行を見つけます

6. 行をクリックし、Valueセルをダブルクリックして完全な文字列をコピーします — s%3Aで始まり、約100文字の長さです

Firefox

1. wanderlog.comにアクセスしてログインします

2. F12を押してDevToolsを開きます

3. Storageタブをクリックします

4. 左側のサイドバーで**Cookies → https://wanderlog.com**を展開します

5. テーブルでconnect.sidを見つけ、クリックしてValueをコピーします

コンソールでdocument.cookieを使えないのはなぜですか？ Wanderlogはconnect.sidをHttpOnlyフラグ付きで設定しており、JavaScriptが読み取ることを意図的にブロックしています（XSS保護）。DevToolsはこの制限を回避します — そのため、DevToolsでは機能し、コンソールでは機能しないのです。

ステップ2 — MCPクライアントを設定

Claude Code

claude mcp add wanderlog-mcp npx wanderlog-mcp \
  --env WANDERLOG_COOKIE="s%3A...your value here..."

Claude Desktop

claude_desktop_config.jsonを編集します：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

保存後、Claude Desktopを再起動します。

Cursor

設定 → MCP → サーバーを追加、または~/.cursor/mcp.jsonを編集します：

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

VS Code（GitHub Copilot）

ワークスペースの.vscode/mcp.jsonに追加します：

{
  "servers": {
    "wanderlog": {
      "type": "stdio",
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

OpenAI Codex

~/.codex/config.tomlを編集します：

[mcp_servers.wanderlog]
command = "npx"
args = ["wanderlog-mcp"]

[mcp_servers.wanderlog.env]
WANDERLOG_COOKIE = "s%3A...your value here..."

Codex内で/mcpを実行してサーバーが読み込まれたことを確認します。

Smithery（ワンクリックインストール）

npx @smithery/cli install wanderlog-mcp --client claude

ステップ3 — 確認

エージェントに次のように尋ねます：「Wanderlogにどんな旅行がありますか？」

wanderlog_list_tripsを呼び出して、アカウントの旅行を返すはずです。失敗した場合は、以下のトラブルシューティングを参照してください。

クッキーの更新

クッキーは約1年間有効ですが、wanderlog.comからログアウトしたり、パスワードを変更したり、Wanderlogがセッションを失効させたりすると、それより早く失効する可能性があります。その場合、すべてのツール呼び出しが次のエラーを返します：

Wanderlogセッションが無効または期限切れです — wanderlog.comのDevToolsから新しいconnect.sidクッキーを取得し、MCP設定のWANDERLOG_COOKIEを更新してください。

上記のステップ1を繰り返し、設定を更新して、MCPクライアントを再起動します。

トラブルシューティング

サーバーは起動するが、list_tripsが認証エラーを返す クッキーが期限切れまたは間違っています。DevToolsから再取得して設定を更新してください。

npx wanderlog-mcpがハングする、または何もしない サーバーはstdio MCPを話します — ターミナルで直接実行するのではなく、MCPホストによって起動されるように設計されています。上記のようにClaude CodeまたはClaude Desktop経由で実行してください。

ツールは動作するが、エージェントがメモ/チェックリストを無視する サーバーはMCP initialize応答に指示を注入し、エージェントに場所とメモを交互に配置し、チェックリストを追加するように指示します。これはClaudeで確実に機能します。他のクライアントでは異なる場合があります。

セキュリティ

• CookieはMCPクライアント設定にのみ保存され、コミットやログに記録されることはありません

• wanderlog-mcpは完全にあなたのマシン上で動作します — リレーサーバーはありません

• 起動時の認証プローブは、Cookieの値を出力せずに検証します

• アクセスを取り消すには: wanderlog.comからログアウトし(すべてのセッションが無効になります)、その後再取得してください

コントリビューション

プルリクエストは歓迎します。提出前に:

npm run build && npm run test

トランスポートまたはツールコードの変更については、以下も実行してください:

npm run test:integration

免責事項

wanderlog-mcpは非公式のサードパーティツールであり、Wanderlogとは提携しておらず、Wanderlogによる承認も受けていません。Wanderlogの非公開のWebクライアントAPIを呼び出して動作しますが、このAPIは予告なく変更される可能性があります。自己責任でご使用ください。

ライセンス

MIT — LICENSEを参照

shaikhspeare 制作