【技术文档摘要】：

[!警告]
此MCP服务器使用polarsteps-api包通过未记录的API访问Polarsteps数据。重要：在使用此工具之前，请阅读相关的法律免责声明和使用条款。使用此MCP服务器即表示您同意API包中概述的条款并认可相关风险。

Polarsteps MCP服务器

这是一个模型上下文协议（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桌面中使用

在您的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

从源码安装

用于开发或手动安装：

# 克隆仓库
git clone https://github.com/remuzel/polarsteps-mcp
cd polarsteps-mcp

# 设置开发环境
just setup
# 或不使用just：
uv sync --dev && uv pip install -e .

开发

运行测试

just test

本地MCP测试

just test-mcp

代码格式化

just lint