健身数据分析服务

XERT MCP服务器

模型上下文协议（MCP）服务器，将Claude连接到XERT API，提供对健身特征、训练负荷、训练和活动的访问。

特性

• 📊 健身签名 -获取您当前的FTP、LTP、HIE和峰值功率
• 🎯 训练状态 -检查新鲜度、训练负荷和推荐的XSS
• 🏋️ 一天的锻炼 -基于人工智能的锻炼建议
• 📋 锻炼 -列表、查看详细信息和导出（ZWO/ERG）
• 🚴 活动 -浏览包含完整XSS指标和MPA数据的活动
• ⬆️ 上传 -上传FIT文件进行分析

安装

先决条件

• Node.js 18或更高版本
• XERT帐户（免费或高级）

设置

1. 克隆存储库：

   复制

   git clone https://github.com/Milofax/xert-mcp.git
   cd xert-mcp
   

2. 安装依赖项：

   复制

   npm install
   

3. 使用XERT进行身份验证：

   复制

   npm run setup-auth
   

   出现提示时，输入XERT电子邮件和密码。代币将保存到 .env.

4. 构建项目：

   复制

   npm run build
   

配置

添加到您的Claude Desktop配置中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "xert": {
      "command": "node",
      "args": ["/path/to/xert-mcp/dist/server.js"]
    }
  }
}

替换 /path/to/xert-mcp 安装的实际路径。

重新启动Claude Desktop以加载服务器。

码头工人

你也可以通过Docker运行服务器：

1.塑造形象

docker build -t xert-mcp .

2.获取XERT代币

首先在本地运行安装脚本以进行身份验证：

npm install
npm run setup-auth

这创造了 xert-tokens.json 使用您的访问和刷新令牌。

3.配置克劳德桌面

{
  "mcpServers": {
    "xert": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "XERT_ACCESS_TOKEN",
        "-e", "XERT_REFRESH_TOKEN",
        "xert-mcp"
      ],
      "env": {
        "XERT_ACCESS_TOKEN": "your-access-token-from-xert-tokens.json",
        "XERT_REFRESH_TOKEN": "your-refresh-token-from-xert-tokens.json"
      }
    }
  }
}

注： 访问令牌将在7天后过期。当它们过期时，运行 npm run setup-auth 再次更新配置中的令牌。

可用工具

用法示例

问克劳德以下问题：

• “我当前的FTP和培训状态如何？”
• “显示我当天的锻炼”
• “列出我过去7天的活动”
• “我昨天骑行的XSS故障是什么？”
• “这周我有什么突破吗？”
• “显示我保存的训练”
• “将我的‘周日耐力’训练导出为ZWO文件”

XERT概念

• 文件传输协议 -功能阈值功率（1小时可持续功率）
• 语言技术平台 -低阈值功率（脂肪燃烧阈值）
• 医院信息交换 -高强度能量（厌氧工作能力）
• PP -峰值功率（最大瞬时功率）
• XSS -Xert应变评分（训练负荷指标）
• 公共管理硕士 -最大可用功率（实时功率限制）

发展

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

许可证管理

服务器自动处理令牌：

• 访问令牌 7天后过期
• 刷新令牌 6个月后到期
• 代币存储在 xert-tokens.json （自动创建）
• 在401错误时，令牌会自动刷新
• 新令牌被持久化以在服务器重启后继续存在

如果身份验证完全失败，请运行 npm run setup-auth 再一次。

MCP漏斗/环境变量

当使用mcp漏斗或类似工具时，来自 xert-tokens.json 优先于环境变量。这确保了即使环境变量包含过时的值，也能使用刷新的令牌。

许可证

麻省理工学院

学分

• XERT -高级自行车分析
• 模型上下文协议 -AI集成标准