fitconverter（fitconverter 开发）

FitConverter 运动数据转换

通过 MCP + HTTP 协议调用 FitConverter 服务，将运动数据从一个平台转换到另一个平台。

1. 新用户必读

⚠️ 首次使用需要获取 API Key

1. 访问 https://api.fitconverter.com/mcp/generate-api-key 获取 API Key
2. 告诉我你的 API Key，我会帮你配置
3. 或者手动配置 mcporter（见下文）

2. 配置 API Key

方式一：对话中配置（推荐）

直接告诉我你的 API Key：

我的 FitConverter API Key 是 fc_mcp_xxxxxx

我会自动帮你配置。

方式二：手动配置 mcporter

编辑 ~/.mcporter/mcporter.json，添加：

{
  "mcpServers": {
    "fitconverter": {
      "baseUrl": "https://api.fitconverter.com/mcp",
      "headers": {
        "Authorization": "Bearer 你的API_KEY"
      }
    }
  }
}

3. 使用方式

配置完成后，直接对话即可：

帮我把华为的运动数据转到高驰
我要把 Keep 的记录转到佳明
转换 GPX 文件到 FIT 格式

4. 支持的平台

数据源（type）

• 文件类型：huawei, zepp, xiaomi, vivo, keep, samsung, dongdong, kml, gpx, tcx, fit
• 同步类型：zepp_sync, keep_sync, codoon_sync, joyrun_sync, xingzhe_sync, garmin_sync_coros

目标平台（destination）

coros, garmin, strava, rqrun, huawei, keep, shuzixindong, xingzhe, igpsport, onelap, fit, tcx, gpx, kml

5. Agent 执行流程

5.1 检查配置

1. 检查 mcporter 是否已配置 fitconverter 服务器
2. 若未配置，引导用户访问 https://api.fitconverter.com/mcp/generate-api-key 获取 API Key

5.2 调用 MCP 工具

# 列出支持的平台
mcporter call fitconverter.list_platforms
# 查询转换状态
mcporter call fitconverter.get_conversion_status

5.3 提交转换任务

⚠️ 重要：zip_file使用 multipart/form-data 上传文件（不是路径，不是Base64）：

curl -X POST "https://api.fitconverter.com/mcp/submit_conversion" \
  -H "Authorization: Bearer fc_mcp_xxx" \
  -F "api_key=fc_mcp_xxx" \
  -F "type=huawei" \
  -F "destination=coros" \
  -F "address=user@example.com" \
  -F "zip_file=@/path/to/upload.zip"

Node.js 示例：

const FormData = require('form-data');
const fs = require('fs');
const https = require('https');

const form = new FormData();
form.append('api_key', 'fc_mcp_xxx');
form.append('type', 'huawei');
form.append('destination', 'coros');
form.append('address', 'user@example.com');
form.append('zip_file', fs.createReadStream('/path/to/upload.zip'));

const options = {
  hostname: 'api.fitconverter.com',
  port: 443,
  path: '/mcp/submit_conversion',
  method: 'POST',
  headers: {
    'Authorization': 'Bearer fc_mcp_xxx',
    ...form.getHeaders()
  }
};

const req = https.request(options, (res) => {
  let data = '';
  res.on('data', (chunk) => { data += chunk; });
  res.on('end', () => { console.log(data); });
});

form.pipe(req);

返回示例：

{
  "status": "payment_required",
  "order_id": "fitId_xxx",
  "qr_image_url": "https://file.fitconverter.com/qr/qr-xxx.png",
  "code_url": "weixin://wxpay/bizpayurl?pr=xxx",
  "amount": "1.00",
  "message": "需要微信支付"
}

5.4 查询转换状态

mcporter call fitconverter.get_conversion_status --args '{
  "api_key": "fc_mcp_xxx",
  "order_id": "fitId_xxx"
}'

6. 返回状态处理

7. 支付二维码展示

当返回 qr_image_url 时，使用 message 工具发送图片：

message({
  action: "send",
  channel: "discord",
  target: "user:用户ID",
  media: "https://file.fitconverter.com/qr/qr-xxx.png",
  caption: "请扫码支付"
})

8. 错误处理

9. API 端点

10. 参数说明

提交转换（submit_conversion）

\* 根据数据源类型选择必填参数

11. 转换模式说明

注意：试用模式有次数限制，正式付费可获得完整功能。

12. 完整示例

curl -X POST "https://api.fitconverter.com/mcp/submit_conversion" \
  -H "Authorization: Bearer fc_mcp_xxx" \
  -F "api_key=fc_mcp_xxx" \
  -F "type=huawei" \
  -F "destination=coros" \
  -F "address=user@example.com" \
  -F "recordMode=trial_" \
  -F "zip_file=@/path/to/upload.zip"