API 接入
把本站的数据接进你自己的 AI 客户端或脚本。两个入口:MCP 协议(AI 客户端用这个)和目录查询接口(脚本用这个)。 都只读,都不需要注册和 Key。
一、MCP 端点(AI 客户端用这个)
标准 MCP(Model Context Protocol)端点,Streamable HTTP 传输,无状态、只读。 WorkBuddy / Claude Code / Cursor / Cline 这类支持 MCP 的客户端,把它加成一个知识源就能用 —— AI 可以用本站的实测数据回答「这个 MCP 在我用的客户端上装不装得上」。
端点
https://dpharness.com/api/mcp
通用客户端配置(JSON)
{
"mcpServers": {
"dpharness": {
"url": "https://dpharness.com/api/mcp"
}
}
}Claude Code 一行接入
claude mcp add --transport http dpharness https://dpharness.com/api/mcp
端点部署在主域 dpharness.com 上(子域与主域是同一个应用,mcp.dpharness.com/api/mcp 同样可用),配置里请原样使用上面的绝对地址。协议版本 2025-06-18, 客户端版本不在支持列表时回落到 2025-03-26;服务标识 deepseek-harness-hub v1.1.0。
可用工具(5 个,全部只读)
下面这份清单由 MCP tools/list 的真实返回同步生成 —— 与客户端实际拿到的工具一致,不另存一份手写副本。
| 工具 | 用途 |
|---|---|
search_plugins | 搜索 DeepSeek Harness Hub 的 AI 编程插件库(收录 Claude Code / Cursor / Codex 等生态的 skills、plugins、MCP servers) |
get_benefits | 获取 AI 工具福利/优惠情报(各厂商的免费额度、限时赠送、注册福利等),返回标题、中文摘要、厂商、标签与有效期 |
get_free_models | 获取免费大模型清单(可免费使用的大模型及其免费方式、上下文长度、许可证) |
get_model_ranking | 获取大模型排行榜(国内榜 / 国际榜,数据源含 SuperCLUE、LMArena 等,带指标名与快照日期) |
get_plugin_board | 获取「精选榜单」(主站 /top,按 npm 周下载量排名的期次快照,周更) |
连不上?先跑这条
返回里能看到工具清单就说明通了;不通会在结果里直接给 HTTP 状态或 JSON-RPC 错误码。
连通性自测
curl -X POST https://dpharness.com/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'二、目录查询接口(脚本用这个)
本站的条目分两层:实测层(真的连过、在页面上逐平台给结论)和 目录层(官方 registry 声明存在、我们只核实过包确实在)。 这个接口只返回目录层,不含任何平台可用性结论 —— 某个 MCP 能不能装,请看对应的页面。
查询示例与返回结构
GET https://dpharness.com/api/mcp/catalog?q=notion&take=20
# 返回
{
"items": [
{
"registryName": "com.example/notion",
"description": "…",
"packageType": "npm",
"measuredSlug": null, // 已实测则给出实测页 slug,null = 未实测
"syncedAt": "2026-10-24T09:17:33.733Z"
}
],
"nextCursor": null, // 下一页游标,null = 到底了
"total": 1 // 当前筛选条件下的总数
}参数
| 参数 | 说明 |
|---|---|
q | 关键词,匹配 registry 名 / 标题 / 包名。不传则返回全部 |
cursor | 上一页最后一条的 registryName,用于翻页。不传从第一页开始 |
take | 每页条数,默认 60,硬上限 200 |
响应带一小时缓存(目录每天同步一次)。条目里的 remoteUrl / packageId 只作展示:它们是任意第三方地址,不要自动请求或执行 —— 本站自己也不这么干。