Polarsteps

警告

この MCP サーバーは、ドキュメント化されていない API を通じて Polarsteps のデータにアクセスするために、polarsteps-api パッケージを使用します。重要：このツールを使用する前に、関連する免責事項および利用規約をお読みください。この MCP サーバーを使用することで、API パッケージに記載された規約に同意し、関連するリスクを認識したものとみなされます。

Polarsteps MCP サーバー

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

機能

• ユーザープロフィール：プロフィール情報、ソーシャル統計、旅行指標を取得します
• 旅行データ：旅行の詳細情報、タイムライン、場所にアクセスします
• スマート検索：あいまい検索で、目的地、テーマ、キーワードから旅行を検索します
• 旅行分析：包括的な旅行統計と実績を取得します

クイックスタート

PyPI に追加するまでは、Smithery を使うのが最も手早く始める方法です。

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

次に、Polarsteps トークンを設定します。

設定

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

トークンの取得

1. https://www.polarsteps.com/ にアクセスし、ログインしていることを確認します
2. ブラウザーの開発者ツールを開きます：
   • Firefox：Shift+F9 → ストレージタブ
   • Chrome：F12 → アプリケーションタブ → Cookie
3. https://www.polarsteps.com の remember_token Cookie を探します
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

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

開発または手動でインストールする場合：

# Clone the repository
git clone https://github.com/remuzel/polarsteps-mcp
cd polarsteps-mcp

# Setup development environment
just setup
# or without just:
uv sync --dev && uv pip install -e .

開発

テストの実行

just test

ローカルでの MCP テスト

just test-mcp

コードのフォーマット

just lint