RideWithGPS MCP服务器
🚴 亲爱的自行车手们！ 欢迎来到RideWithGPS MCP服务器——您的人工智能伴侣，用于管理您的自行车冒险。如果你喜欢这个项目，请考虑给它一颗星，或者更好的是，成为一名贡献者！
模型上下文协议（MCP）服务器，提供对RideWithGPS API的访问，允许您与路线、行程、事件和用户数据进行交互。
需求
- Node.js：18.0.0或更高版本，建议使用20.0.0或更新版本(点击此处下载)
工具
此MCP服务器实现了以下工具：
路线Retetiner
- get_routes：检索用户在RideWithGPS上拥有的路线列表，按updated_at降序排列
⚠️ 已知限制： 此工具只能访问您个人拥有的路线。 与您共享但属于其他人的路线不会出现在您的结果中。\ 如果您想与此服务器使用共享路线，请先将其复制到您自己的RideWithGPS帐户中。
- get_route_details：检索特定路线的完整详细信息，包括赛道点、赛道点和兴趣点。您可以找到可用的信息列表 这里
行程和活动数据
- get_trips：检索用户在RideWithGPS上拥有的行程/活动列表，按updated_at降序排列
- 获取trip_details：检索特定行程的完整详细信息，包括跟踪点和性能数据。您可以找到可用的信息列表 这里
用户档案
- get_current_user：检索用户的配置文件信息
活动参与
- get_events：检索用户拥有的事件的分页列表，按created_at降序排列
- 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的应用程序。其他常见的MCP客户端也应该工作。
您可以从以下网址获取RideWithGPS API证书：
- API密钥：访问 开发人员设置页面 在您的RideWithGPS帐户中，并创建一个API客户端
- 认证凭证：选择您创建的API客户端并转到其编辑页面。点击“创建新的身份验证令牌”以获取新的身份认证令牌。
然后，打开您的Claude Desktop设置，转到开发人员，然后选择“编辑配置”。或者，在您的 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
发展
欢迎贡献者！为该项目做出贡献：
- 将此存储库分叉到您自己的GitHub帐户。
- 在本地克隆你的叉子。
- 安装依赖项：
npm install - 在中对TypeScript源文件进行更改
src/ - 构建项目：
npm run build - 使用测试您的更改
npm run inspector - 提交并将你的更改推到你的叉子上。
- 向主存储库提交拉取请求以供审查。
发展路线图
- 利用OAuth进行安全的用户身份验证
- 将MCP服务器部署到Smithery/Glama进行分发
- 纳入具有地理空间意识的跟踪点；目前，只显示数字
- 将分页设置为可选；按出发时间而不是更新时间降序返回行程也会有所帮助。
许可证
此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。