Runalyze MCP Server

🏃 分析MCP服务器

使用模型上下文协议（MCP）通过AI助手访问Runalyze健康指标

一个安全的MCP服务器，允许您直接在Claude Desktop和ChatGPT Desktop等AI聊天应用程序中从Runalyze帐户检索健康数据（HRV、睡眠、静息心率、活动）。

______________________________________________________________________

🎯 选择您的设置

此服务器可用于 双向。选择最适合您的选项：

🖥️ 本地设置

在您自己的计算机上运行

赞成的意见：

• ✅ 完全隐私-数据保留在您的计算机上
• ✅ 安装后不需要互联网
• ✅ 免费使用
• ✅ 完全控制

欺骗：

• ⚠️ 需要安装Node.js
• ⚠️ 需要从源代码构建
• ⚠️ 仅在安装了它的计算机上工作

设置时间： 约5分钟

👉 本地设置

☁️ 托管安装程序

使用我们的托管服务器

赞成的意见：

• ✅ 无需安装
• ✅ 适用于任何设备
• ✅ 始终保持最新状态
• ✅ 快速2分钟设置

欺骗：

• ⚠️ 需要互联网连接
• ⚠️ 取决于托管服务的可用性

设置时间： 约2分钟

服务器URL: https://runalyze-mcp-server.fly.dev

👉 使用托管版本

安全说明： 这两种选择都是安全的。托管版本不存储您的API令牌-您为每个请求提供它，就像本地版本将其存储在配置文件中一样。

______________________________________________________________________

📖 目录

• 选项1：本地设置

- 先决条件 - 安装 - 配置您的AI工具

• 选项2：托管安装

- 配置您的AI工具

• 你能做什么
• 故障排除

______________________________________________________________________

🖥️ 选项1：本地设置

在您自己的计算机上运行MCP服务器。

先决条件

在开始之前，请确保您已经：

• 纱线 包管理器(安装指南)
• A. Runalyze帐户 具有高级访问权限(获得保费)
• 一 AI助手 支持MCP（克劳德桌面、ChatGPT桌面、VS代码扩展等）

安装

第一步：下载并构建

# Clone the repository
git clone https://github.com/floriankimmel/runalyze-mcp-server.git
cd runalyze-mcp-server

选项A：使用Devbox（推荐）

开发箱 提供隔离、可重复的开发环境。

1. 安装devbox和direnv：

   # macOS
   brew install devbox direnv

1. 在项目中启用direnv：

   direnv allow

1. 运行devbox脚本：

   devbox run install  # yarn install
   devbox run build    # yarn build
   devbox run dev      # yarn start:dev
   devbox run dev:http # yarn start:http:dev

选项B：手动设置

# Install dependencies
yarn install

# Build the server
yarn build

编译后的服务器将位于 dist/ 目录。

第2步：获取Runalyze API代币

1. 登录您的Runalyze帐户
2. 首选 设置→ 个人API: https://runalyze.com/settings/personal-api
3. 点击 生成新令牌
4. 复制令牌（下一步需要它）

配置您的AI工具（本地）

选择您的AI助手并按照配置步骤进行操作：

适用于克劳德桌面🟣

1. 找到您的配置文件：

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json

1. 添加服务器配置：

{
  "mcpServers": {
    "runalyze": {
      "command": "node",
      "args": [
        "/absolute/path/to/runalyze-mcp-server/dist/main.js"
      ],
      "env": {
        "RUNALYZE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

1. 替换以下值：

- 改变 /absolute/path/to/runalyze-mcp-server 安装服务器的位置 - 替换 your-api-token-here 使用Runalyze API令牌

1. 重新启动克劳德桌面

适用于ChatGPT桌面🟢

1. 打开ChatGPT桌面设置

1. 引导到 开发人员设置 → MCP服务器

1. 点击 添加服务器 并配置：

- 名字: runalyze - 命令: node - 参数: /absolute/path/to/runalyze-mcp-server/dist/main.js - 环境变量: - 密钥： RUNALYZE_API_TOKEN - 价值： your-api-token-here

1. 保存并重新启动ChatGPT桌面

对于Cline（VS代码扩展）💙

1. 打开VS代码设置（JSON）
2. 添加此配置：

{
  "mcp.servers": {
    "runalyze": {
      "command": "node",
      "args": [
        "/absolute/path/to/runalyze-mcp-server/dist/main.js"
      ],
      "env": {
        "RUNALYZE_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

1. 将路径和标记替换为您的值
2. 重新加载VS代码

继续（VS代码扩展）🔵

1. 打开继续配置文件(~/.continue/config.json)
2. 添加到 mcpServers 数组：

{
  "mcpServers": [
    {
      "name": "runalyze",
      "command": "node",
      "args": [
        "/absolute/path/to/runalyze-mcp-server/dist/main.js"
      ],
      "env": {
        "RUNALYZE_API_TOKEN": "your-api-token-here"
      }
    }
  ]
}

1. 将路径和标记替换为您的值
2. 重新启动继续

Zed编辑🌟

1. 打开Zed设置(~/.config/zed/settings.json)
2. 添加此配置：

{
  "mcp": {
    "servers": {
      "runalyze": {
        "command": "node",
        "args": [
          "/absolute/path/to/runalyze-mcp-server/dist/main.js"
        ],
        "env": {
          "RUNALYZE_API_TOKEN": "your-api-token-here"
        }
      }
    }
  }
}

1. 将路径和标记替换为您的值
2. 重新启动Zed

______________________________________________________________________

☁️ 选项2：托管安装

使用我们的托管MCP服务器-无需安装！

服务器URL: https://runalyze-mcp-server.fly.dev

获取Runalyze API代币

1. 登录您的Runalyze帐户
2. 首选 设置→ 个人API: https://runalyze.com/settings/personal-api
3. 点击 生成新令牌
4. 复制令牌（下一步需要它）

配置您的AI工具（托管）

选择您的AI助手并按照配置步骤进行操作：

适用于克劳德桌面🟣

注： Claude Desktop目前仅支持STDIO传输。要使用托管版本，您需要一个HTTP到STDIO桥。目前，我们建议使用 本地设置 克劳德桌面。

适用于ChatGPT桌面🟢

注： 检查ChatGPT Desktop是否支持MCP服务器的HTTP传输。如果没有，请使用 本地设置 相反。

适用于支持HTTP的MCP客户端

如果您的AI工具支持MCP over HTTP，请使用以下配置：

• 端点URL: https://runalyze-mcp-server.fly.dev/mcp
• 认证：不记名代币
• 代币：您的Runalyze API代币

配置格式示例：

{
  "mcpServers": {
    "runalyze": {
      "url": "https://runalyze-mcp-server.fly.dev/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_RUNALYZE_TOKEN"
      }
    }
  }
}

直接使用HTTP API

您还可以通过HTTP直接使用托管服务器：

健康检查 （无需身份验证）：

curl https://runalyze-mcp-server.fly.dev/health

获取HRV数据：

curl -X POST https://runalyze-mcp-server.fly.dev/mcp \
  -H "Authorization: Bearer YOUR_RUNALYZE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "get-runalyze-hrv-data",
      "arguments": {"page": 1}
    }
  }'

获取活动：

curl -X POST https://runalyze-mcp-server.fly.dev/mcp \
  -H "Authorization: Bearer YOUR_RUNALYZE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "get-runalyze-activities",
      "arguments": {"page": 1}
    }
  }'

获取活动详细信息：

curl -X POST https://runalyze-mcp-server.fly.dev/mcp \
  -H "Authorization: Bearer YOUR_RUNALYZE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "get-runalyze-activity-detail",
      "arguments": {"id": 12345}
    }
  }'

______________________________________________________________________

🎯 你能做什么

配置后，您可以向AI助手提出以下问题：

活动

• “显示Runalyze最近的活动”
• “我本周记录了哪些锻炼？”
• “获取活动12345的详细信息”
• “分析我上个月的跑步数据”

心率变异性

• “我最新的HRV数据是什么？”
• “显示我过去一个月的HRV趋势”
• “根据HRV，我的恢复情况如何？”

睡眠数据

• “显示我上周的睡眠数据”
• “我昨晚睡了几个小时？”
• “这个月我的睡眠模式是什么？”

静息心率

• “今天早上我的静息心率是多少？”
• “显示我的静息心率趋势”
• “我的静息心率是否有所改善？”

AI将自动获取您的数据并提供见解！

可用工具

服务器为您的AI助手提供以下工具：

1. get-runalyze-activities -获取您的活动列表（跑步、骑行、锻炼）
2. get-runalyze-activity-detail -获取特定活动的详细信息
3. get-runalyze-hrv-data -检索心率变异性测量值
4. get-runalyze-sleep-data -获取睡眠跟踪数据
5. get-runalyze-heart-rate-rest-data -获取静息心率测量值

所有工具都支持分页浏览历史数据。

______________________________________________________________________

🔒 安全说明

本地设置

• 您的API令牌存储在您计算机上MCP客户端的配置文件中
• 所有通信都在您的机器上本地进行
• 不向第三方发送数据
• 启动时验证令牌

托管安装程序

• 服务器上没有存储令牌
• 每个请求都需要在授权标头中使用Runalyze API令牌
• 您只能访问自己的数据
• 所有通信均通过HTTPS进行
• 服务器是无状态的——它不记得请求之间的任何事情

这两种选择都是安全的。 根据您的喜好选择：

• 本地 =最大限度的隐私，您机器上的一切
• 托管 =方便，无需安装

______________________________________________________________________

🐛 故障排除

本地设置问题

服务器无法启动

• ✅ 检查您的API令牌是否有效：https://runalyze.com/settings/personal-api
• ✅ 验证路径 dist/main.js 绝对正确
• ✅ 确保已安装Node.js v18+： node --version
• ✅ 检查你跑了 yarn build 成功地
• ✅ 试着跑步 node /absolute/path/to/dist/main.js 手动查看错误消息

“配置验证失败”

• ✅ 这 RUNALYZE_API_TOKEN 配置中缺少环境变量
• ✅ 仔细检查MCP客户端配置语法（有效的JSON）
• ✅ 确保令牌没有多余的空格或引号

未返回数据

• ✅ 验证您的Runalyze帐户中是否有数据
• ✅ 检查您的帐户是否具有高级/支持者访问权限（API需要）
• ✅ 确保您的API令牌具有必要的权限
• ✅ 尝试访问https://runalyze.com/api/v1/metrics/hrv登录时直接在浏览器中

AI助手看不到工具

• ✅ 配置更改后重新启动AI助手
• ✅ 检查MCP服务器是否出现在AI助手的MCP服务器列表中
• ✅ 在AI助手的日志/开发人员控制台中查找错误消息
• ✅ 验证JSON配置是否有效（使用JSON验证器）

托管安装问题

连接失败

• ✅ 检查服务器是否正在运行： curl https://runalyze-mcp-server.fly.dev/health
• ✅ 验证您是否具有互联网连接
• ✅ 确保URL正确： https://runalyze-mcp-server.fly.dev/mcp

身份验证错误（401未经授权）

• ✅ 确保你包括 Authorization: Bearer YOUR_TOKEN 头球
• ✅ 验证您的Runalyze API令牌是否有效且未过期
• ✅ 检查令牌中没有多余的空格
• ✅ 确保您从Runalyze复制了完整的令牌

404或其他错误

• ✅ 验证端点路径是否为 /mcp 不仅仅 /
• ✅ 检查您使用的是POST方法，而不是GET方法
• ✅ 确保Content-Type标头为 application/json

AI工具不支持HTTP传输

• ✅ 许多MCP客户端目前仅支持STDIO传输
• ✅ 使用 本地设置 相反
• ✅ 或者直接与curl/脚本一起使用HTTP API

一般问题

还有问题吗？

1. 在上查看您的Runalyze API令牌https://runalyze.com/settings/personal-api
2. 验证您是否具有高级访问权限：https://runalyze.com/premium
3. 审查 Runalyze API文档
4. 检查 MCP文件
5. 打开一个问题

______________________________________________________________________

📚 了解更多

• 🏃 Runalyze -培训分析平台
• 📖 模型上下文协议 -MCP规范
• 🤖 克劳德桌面 -AI助手
• 💬 ChatGPT -AI助手

______________________________________________________________________

🚀 对于开发者

想贡献或部署自己的实例吗？查看：

• 贡献.md -开发设置和指南
• Fly.io部署指南 -托管自己的实例

______________________________________________________________________

📝 许可证

麻省理工学院

______________________________________________________________________

由以下材料制成❤️ Runalyze社区