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