🚀 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 请求进行身份验证。
获取令牌
- 访问 https://www.polarsteps.com/ 并确保你已登录。
- 打开浏览器的开发者工具：
- Firefox：Shift + F9 → 存储标签页
- Chrome：F12 → 应用程序标签页 → Cookie
- 找到适用于 https://www.polarsteps.com 的
remember_tokenCookie。 - 复制令牌值。
设置令牌
将令牌设置为环境变量：
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