wanderlog-mcp

Claude（またはMCP互換エージェント）が会話を通じてWanderlogの旅行日程を表示・構築できるようにするMCPサーバーです。

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

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

エージェントがツールを呼び出し、各日の場所やメモを挿入し、ホテルブロックやチェックリストを追加することで、数分で完全に構成されたWanderlogの旅行日程が完成します。

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

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

Settings → MCP → Add server、または~/.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 session invalid or expired — 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で確実に動作します。他のクライアントでは動作が異なる場合があります。

セキュリティ

• クッキーはMCPクライアントの設定内にのみ保存され、コミットやログ出力はされません

• wanderlog-mcpは完全にローカルマシン上で動作し、中継サーバーはありません

• 起動時の認証チェックは、値を表示することなくクッキーを検証します

• アクセスを取り消すには：wanderlog.comからログアウト（全セッションが無効化されます）し、再度取得してください

貢献

プルリクエストを歓迎します。提出前に以下を実行してください：

npm run build && npm run test

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

npm run test:integration

免責事項

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

ライセンス

MIT — LICENSEを参照

Made by shaikhspeare