金大哥 - ridewithgps-mcp MCP 详情

article

README

🚀 RideWithGPS MCP 服务器

RideWithGPS MCP 服务器是您管理骑行冒险的 AI 助手，它基于 Model Context Protocol (MCP)，为您提供访问 RideWithGPS API 的途径，让您可以轻松与路线、行程、活动和用户数据进行交互。

🚀 快速开始

要求

Node.js：版本 18.0.0 或更高，建议使用 20.0.0 及以上版本（点击此处下载）

工具

此 MCP 服务器实现了以下工具：

路线检索

get_routes：获取用户在 RideWithGPS 上拥有的路线列表，按更新时间降序排列。

⚠️ 已知限制：此工具只能访问您个人拥有的路线。与您共享但属于他人的路线不会出现在结果中。 如果您想在此服务器上使用共享路线，请先将其复制到您自己的 RideWithGPS 账户中。

get_route_details：获取特定路线的完整详细信息，包括轨迹点、路线点和兴趣点。您可以在此处查看可用的信息列表。

行程与活动数据

get_trips：获取用户在 RideWithGPS 上拥有的行程/活动列表，按更新时间降序排列。
get_trip_details：获取特定行程的完整详细信息，包括轨迹点和性能数据。您可以在此处查看可用的信息列表。

用户资料

get_current_user：获取用户的个人资料信息。

活动参与

get_events：获取用户拥有的活动的分页列表，按创建时间降序排列。
get_event_details：获取特定活动的完整详细信息，包括相关路线。

数据同步

sync_user_data：获取用户自指定日期时间以来与之交互过的项目（路线和/或行程）。

安装

在命令行中，克隆此仓库并进入其目录

git clone https://github.com/boezzz/ridewithgps-mcp.git
cd ridewithgps-mcp

构建服务器应用程序

npm install
npm run build

配置 Claude 桌面应用 您可以安装支持 MCP 的 Claude 桌面应用，其他常见的 MCP 客户端也应该可以使用。

您可以从以下位置获取 RideWithGPS API 凭证：

API 密钥：访问您的 RideWithGPS 账户中的开发者设置页面，并创建一个 API 客户端。
身份验证令牌：选择您创建的 API 客户端并进入其编辑页面，点击“创建新的身份验证令牌”以获取新的身份验证令牌。

访问令牌说明

然后，打开您的 Claude 桌面应用设置，转到“开发者”，并选择“编辑配置”。或者，在您的 claude_desktop_config.json 文件中添加一个新的 MCP 服务器：

{
  "mcpServers": {
    "ridewithgps-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/ridewithgps-mcp/build/index.js"],
      "env": {
        "RWGPS_API_KEY": "your_api_key_here",
        "RWGPS_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

现在，您可以启动 Claude 桌面应用，并让它与您的 RideWithGPS 数据进行交互。

示例查询

“显示我最近的路线”
“获取我昨天创建的世纪路线的详细信息”
“列出我上个月的骑行行程”
“我即将参加哪些活动，我可能会临阵退缩？”
“显示我的用户资料，这样我就可以欣赏我乐观设定的低体重了”
“同步我自上周以来的数据，当时我假装去咖啡店的步行是一次训练骑行”

要在其他本地 MCP 客户端上使用 RideWithGPS MCP 服务器，请遵循相同的步骤。

📚 详细文档

API 覆盖范围

此 MCP 服务器实现了 RideWithGPS API 中针对个人用户的主要端点，不包括特定于组织的功能。

完整的 API 文档请参阅：https://github.com/ridewithgps/developers

开发

欢迎贡献代码！要为这个项目做出贡献，请按以下步骤操作：

将此仓库 fork 到您自己的 GitHub 账户。
在本地克隆您的 fork。
安装依赖项：npm install
在 src/ 目录下的 TypeScript 源文件中进行更改。
构建项目：npm run build
使用 npm run inspector 测试您的更改。
提交并将您的更改推送到您的 fork。
向主仓库提交拉取请求以进行审核。

开发路线图

使用 OAuth 进行安全的用户身份验证。
将 MCP 服务器部署到 Smithery/Glama 进行分发。
整合地理空间感知的轨迹点；目前仅显示数量。
使分页可选；按出发时间降序而不是更新时间返回行程也会很有帮助。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

ridewithgps-mcp