Openpowerlifting

@pipeworx/openpowerlifting

来自 OpenPowerlifting 项目的力量举比赛成绩——举重运动员逐场比赛的历史记录、某场比赛的完整成绩，以及按性别、装备和体重级别划分的历史最佳举重成绩。全球约有 4,000,000 条举重运动员记录，涵盖约 64,000 场比赛。

属于 Pipeworx——一个将 AI Agent 接入 1,872 多个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关，未获其认可，也非其发布。

工具

• opl_lifter_history(name, equipment?, limit?, offset?) ——举重运动员参加的每场比赛（按时间从近到远排列），包含联合会、组别、体重、体重级别、深蹲／卧推／硬拉最佳成绩、总成绩、名次及 Dots／Wilks／Goodlift 分数，以及职业生涯最佳成绩。同名举重运动员在数据中会编号（“John Smith #2”）；名称不明确时，会返回候选项，而不会混合他们的记录。
• opl_meet_results(meet_id | meet [+ federation, year], sex?, equipment?, weight_class?, division?, limit?, offset?) ——某场比赛的举重运动员名单，按性别、装备、组别、体重级别和名次排序。名称匹配多场比赛时，会返回候选列表。
• opl_records(sex, equipment?, lift?, weight_class?, federation?, age_class?, tested?, year?, event?, limit?) ——按总成绩、深蹲、卧推、硬拉或 Dots 分数排列的最佳成绩，每位举重运动员一行（取其符合条件的最佳记录）。这些是给定筛选条件下数据中的最佳记录，并非联合会的官方纪录列表。

所有重量单位均为千克。每条响应都包含 source、licence 和 data_as_of（所加载文件的发布日期）。

身份验证

无需密钥。

数据源

• OpenPowerlifting（openpowerlifting.org），力量举比赛成绩数据库。

许可协议。 该项目将数据奉献至公有领域，并放弃对数据的一切版权及相关权利；项目要求注明出处，但不作强制要求。这些成绩是由该项目自行发布的公开比赛记录。

此数据副本包含和不包含的内容。

• 保留三次试举中的最佳成绩、总成绩、名次、分数，以及比赛和举重运动员的描述信息。不包含单次试举记录（深蹲 1-4、卧推 1-4、硬拉 1-4，以及成功／失败标记）。
• 该文件是某一时点的快照：新比赛会在下次重新加载时出现，项目也会随时间更正旧记录。data_as_of 是所加载文件的发布日期；latest_meet_date 是文件中最新比赛的日期。
• 同名举重运动员。 项目会为已知的同名举重运动员编号（“John Smith #2”），但不一定总能区分两个人；未编号的姓名仍可能混合多人的成绩，因此在将一段历史视为同一人的记录前，请检查 career 中的联合会和年份。
• place 是文本：数字，或 DQ（取消资格）、G（嘉宾）、NS（未出场）、DD（因兴奋剂问题取消资格）。
• 装备类别是联合会定义的类别，不一定与举重运动员实际穿戴的装备相符。tested 表示联合会是否进行药检。
• 只有举重运动员完成该项目的所有举重动作时，才会记录总成绩；默认情况下，opl_records 按完整的三项（SBD）记录中的总成绩排名。
• 体重级别按记录中的字符串原样保留（83、84+）；超重量级以 + 形式表示。

更新数据

OpenPowerlifting 每天都会重新生成文件。使用以下命令重新加载（需要已登录 Pipeworx Cloudflare 账户的 wrangler）：

node scripts/openpowerlifting/load-data.mjs

加载器会删除并重新加载这些表，核对行数是否与生成的行数一致；如不一致则以非零状态退出。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "openpowerlifting": {
      "url": "https://gateway.pipeworx.io/openpowerlifting/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/openpowerlifting/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于表中的数量：目前，单个套件端点除了套件自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，也是当天情况的权威答案。

这是有意为之，并非意外多路复用。元工具让限定范围的连接也能回答本套件未涵盖的问题——通过 ask_pipeworx 跨整个目录路由——而无需添加第二个 MCP 服务。目前无法挂载不包含这些工具的套件端点；如果额外的 schema 占用的上下文超过路由带来的收益，请连接一次完整网关，而不是连接多个套件端点。

或者连接完整的 Pipeworx 网关，直接列出所有套件的工具，而不仅仅是这一套：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1872+ 个数据源。唯一的区别是直接列出哪些套件的工具；ask_pipeworx 从任一端点都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/opl_lifter_history \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ed Coan","limit":5}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/opl_lifter_history。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "openpowerlifting": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-openpowerlifting"]
    }
  }
}

或者直接运行，以确认它能启动：

npx -y @pipeworx/mcp-openpowerlifting

它通过 stdin/stdout 使用 MCP，并仅针对本套件的工具响应 initialize/tools/list/tools/call——不包含上文网关连接所添加的任何共享元工具。相同的源代码，相同的工具，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不是直接调用工具——套件端点和完整网关都支持此功能：

ask_pipeworx({ question: "your question about Openpowerlifting data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT