Polarsteps MCP

🚀 Polarsteps MCP Server

このサーバーは Model Context Protocol (MCP) を使用しており、Claudeや他のAIアシスタントがPolarstepsの旅行データにアクセスできるようにします。ユーザープロファイル、旅行詳細、旅行統計を照会し、自然言語で旅行履歴を検索することができます。

⚠️ 重要な注意事項

このMCPサーバーは polarsteps-api パッケージを使用して、非公開のAPIを介してPolarstepsのデータにアクセスします。重要: このツールを使用する前に、関連する法的免責事項と使用条件を必ず読んでください。このMCPサーバーを使用することで、APIパッケージに記載されている条件に同意し、関連するリスクを承知したことになります。

✨ 主な機能

• ユーザープロファイル：プロファイル情報、ソーシャル統計、旅行指標を取得します。
• 旅行データ：詳細な旅行情報、タイムライン、場所にアクセスします。
• スマート検索：目的地、テーマ、またはキーワードでファジーマッチングを使用して旅行を検索します。
• 旅行分析：包括的な旅行統計と成果を取得します。

🚀 クイックスタート

このパッケージをPyPIに追加するまでは、Smithery を使用するのが最も簡単な方法です。

npx -y @smithery/cli install @remuzel/polarsteps-mcp --client claude

その後、Polarstepsのトークンを設定します。

📦 インストール

ソースからのインストール

開発または手動インストールの場合は、以下の手順を実行します。

# リポジトリをクローンする
git clone https://github.com/remuzel/polarsteps-mcp
cd polarsteps-mcp

# 開発環境をセットアップする
just setup
# またはjustを使用しない場合は
uv sync --dev && uv pip install -e .

🔧 設定

APIリクエストを認証するには、Polarstepsの remember_token が必要です。

トークンの取得

1. https://www.polarsteps.com/ にアクセスし、ログインしていることを確認します。
2. ブラウザの開発ツールを開きます。
   • Firefox: Shift+F9 → ストレージタブ
   • Chrome: F12 → アプリケーションタブ → クッキー
3. https://www.polarsteps.com の remember_token クッキーを見つけます。
4. トークンの値をコピーします。

トークンの設定

トークンを環境変数として設定します。

export POLARSTEPS_REMEMBER_TOKEN="your_remember_token_here"

💻 使用例

Claude Desktopでの使用

Claude Desktopの設定に次の構成を追加します。

{
  "mcpServers": {
    "polarsteps": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/remuzel/polarsteps-mcp", "polarsteps-mcp"],
      "env": {
        "POLARSTEPS_REMEMBER_TOKEN": "your_remember_token_here"
      }
    }
  }
}

クエリの例

設定が完了したら、Claudeに次のような質問をすることができます。

• "ユーザー名 'johndoe' の旅行統計を表示してください"
• "johndoeの日本旅行について教えてください"
• "johndoeがバケットリストに追加すべき国はどれですか？"

ローカルでのテスト

インスペクターを使用してMCPサーバーをローカルでテストします。

npx @modelcontextprotocol/inspector uvx --from git+https://github.com/remuzel/polarsteps-mcp polarsteps-mcp

🔧 開発

テストの実行

just test

ローカルでのMCPテスト

just test-mcp

コードフォーマット

just lint