Polarsteps MCP

🚀 Polarsteps MCP 服務器

Polarsteps MCP 服務器是一個基於 模型上下文協議 (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 .

💻 使用示例

配置 Polarsteps 令牌

你需要使用 Polarsteps 的 remember_token 來對 API 請求進行身份驗證。

獲取令牌

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 桌面版配合使用

將以下配置添加到你的 Claude 桌面版設置中：

{
  "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