Polarsteps

警告

此 MCP 服务使用 polarsteps-api 软件包，通过未公开的 API 访问 Polarsteps 数据。重要提示：使用此工具前，请阅读相关的法律免责声明和使用条款。使用此 MCP 服务即表示你同意 API 软件包中列出的条款，并知悉相关风险。

Polarsteps MCP 服务

一个 Model Context Protocol (MCP) 服务，可让 Claude 和其他 AI 助手访问 Polarsteps 旅行数据。通过自然语言查询用户个人资料、旅行详情、旅行统计数据，并搜索旅行记录。

功能

• 用户个人资料：获取个人资料信息、社交统计数据和旅行指标
• 旅行数据：访问详细的旅行信息、时间线和地点
• 智能搜索：通过模糊匹配，按目的地、主题或关键词查找旅行
• 旅行分析：获取全面的旅行统计数据和成就

快速开始

在我将其发布到 PyPI 之前，最快的入门方式是使用 Smithery：

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

然后配置你的 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 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