AI导哈

旅行数据查询服务

一个通过Model Context Protocol (MCP)服务器访问Polarsteps旅行数据的工具，支持查询用户资料、旅行详情、旅行统计和搜索旅行历史。

  • by remuzel
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 remuzel/polarsteps-mcp

使用说明

[！警告]
此MCP服务器使用 polarsteps-api 通过未记录的API访问Polarstep数据的包。 重要：请阅读相关 法律免责声明和使用条款 在使用此工具之前。通过使用此MCP服务器，您同意API软件包中列出的条款，并承认相关风险。

Polarstep MCP服务器

A. 模型上下文协议（MCP） 服务器，使克劳德和其他人工智能助手能够访问Polarstep的旅行数据。查询用户资料、旅行详情、旅行统计数据，并使用自然语言搜索旅行历史。

特性

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

快速开始

在我将其添加到PyPI之前，最快的入门方法是使用 史密瑟里:

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

然后配置您的Polarstep令牌。

配置

你需要你的Polarsteps remember_token 以验证API请求。

获取您的令牌

  1. 首选https://www.polarsteps.com/并确保您已登录
  2. 打开浏览器的开发工具：
    • 火狐：Shift+F9→ 存储选项卡
    • 铬：F12→ 应用程序选项卡→ Cookie
  3. 查找 remember_token 饼干https://www.polarsteps.com
  4. 复制令牌值

设置令牌

将令牌设置为环境变量：

export POLARSTEPS_REMEMBER_TOKEN="your_remember_token_here"

用法

使用克劳德桌面

将此配置添加到您的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'的旅行统计信息”
  • “跟我说说约翰的日本之旅”
  • “约翰多应该把哪个国家列入他们的候选名单？”

局部测试

使用检查器在本地测试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

相关 MCP