Versuz

---

功能

Model Context Protocol 是 Anthropic 制定的标准，可让 Claude Code 调用外部工具。@versuz/mcp 将 Versuz 目录作为 5 个工具提供，因此你可以这样说：

“帮我找一个 SQL 迁移技能并安装它”

“列出适用于 Next.js 项目的排名前 10 的 CLAUDE.md 文件”

“告诉我 pdf-pro 技能的先验分数和 Elo 分数”

Claude 会调用这些工具、汇总结果并下载合适的文件。无需复制粘贴，也无需切换浏览器。

安装

claude mcp add versuz npx -y @versuz/mcp

或者通过项目中的 .mcp.json 手动配置：

{
  "mcpServers": {
    "versuz": {
      "command": "npx",
      "args": ["-y", "@versuz/mcp"],
      "env": {
        "VERSUZ_API": "https://versuz.dev"
      }
    }
  }
}

重启 Claude Code。5 个 Versuz 工具便会出现在工具列表中。

提供的工具

工具	描述
versuz_search	跨技能 + CLAUDE.md 进行全文搜索。返回每种类型中排名前 15 的结果。
versuz_list_skills	分页浏览，支持 category / tier / sort 筛选。
versuz_list_claude_md	同样的浏览方式，适用于 CLAUDE.md（类别：nextjs · react · python-data · backend-api · mobile · devops · ml-training · generic）。
versuz_get	获取指定 slug 的完整详情 — Elo、先验分数、许可证、GitHub URL、捆绑文件、工具和模型。
versuz_install	下载到 .claude/skills/<slug>/SKILL.md（技能）或 ./CLAUDE.md（claude_md）。仅限免费项目。付费项目会返回 buy_url。

会话示例

你：“我需要一个能从 PDF 中提取表格的技能。”

Claude：

[invoking versuz_search({query: "pdf table extraction"})]

Found 3 candidates :
- pdf-table-extractor (prior 1721, ★ 8.2k, FEATURED $4.99)
- pdf-extract-anthropic (prior 1846, ★ 12.4k, FREE)
- table-from-pdf-claude (prior 1432, ★ 950, FREE)

Recommend pdf-extract-anthropic — highest prior + free. Install ?

你：“好”

Claude：

[invoking versuz_install({slug: "pdf-extract-anthropic"})]

✓ Wrote .claude/skills/pdf-extract-anthropic/SKILL.md (3.2 KB)
Source : github.com/anthropics/skills/blob/main/pdf-extract/SKILL.md

配置

环境变量	默认值	作用
VERSUZ_API	https://versuz.dev	API 主机。本地开发时可设为 http://localhost:3000。

也可以通过 MCP 配置传入：

{
  "mcpServers": {
    "versuz": {
      "command": "npx",
      "args": ["-y", "@versuz/mcp"],
      "env": { "VERSUZ_API": "http://localhost:3000" }
    }
  }
}

安装路径

工具会将文件写入Claude Code 运行时所在的项目根目录，而不是 MCP 服务所在的目录：

类型	目标位置
skill	<project>/.claude/skills/<slug>/SKILL.md
claude_md	<project>/CLAUDE.md

如有需要，可通过 versuz_install 的 cwd 参数覆盖。

付费项目处理

付费项目会从 API 返回 402 Payment Required。MCP 服务会转发清晰的提示信息：

Error: Premium skill — purchase required to download via MCP.
Buy at: https://versuz.dev/buy/skill/<slug>

在网站上购买后，即可正常安装（在 v0.2 中实现 — 目前 MCP 不会传递用户身份验证信息，因此只能下载免费项目）。

捆绑包支持（v0.2）

与 CLI 一样存在相同限制：捆绑技能（SKILL.md + scripts/refs）目前只会下载 SKILL.md。待 /api/v1/skills/<slug>/bundle.zip 发布后，路线图中将支持在 versuz_install 中使用 bundle: true 参数。

路线图（v0.2）

• versuz_submit 工具 — 从你自己的 GitHub 仓库发布技能（与 CLI 类似）
• GitHub Device Flow 身份验证 — 通过 MCP 下载付费项目
• 捆绑包下载 — 支持 zip
• versuz_judge — 从 MCP 启动质量评审运行（仅限管理员）

开发

cd mcp-server
npm install
node bin/server.js          # runs on stdio, waits for MCP client

服务器启动时会将 [versuz-mcp] running on stdio · api=<url> 记录到 stderr。stdout 专用于 MCP 协议。

使用 @modelcontextprotocol/inspector 独立测试：

npx @modelcontextprotocol/inspector node bin/server.js

技术栈

• @modelcontextprotocol/sdk ^1.0
• Stdio 传输（不监听网络）
• 纯 Node 18+、ESM

许可证

MIT — 详见 LICENSE。