modelbound-mcp

modelbound-mcp

面向 Agent 技能、本地优先的 MCP 服务。验证、检查、比较和转换 Cursor、Claude、Codex、Kiro、Windsurf、VS Code 和 Amazon Q 中的 Agent 技能文件——无需账户。可选择与 ModelBound 云端同步。

为什么选择 ModelBound？

AI 工具不断涌现。你今天可能用 Cursor，明天改用 Claude Code，下周又试试 Kiro——但你的技能、规则和上下文不应该被锁定在某一个工具中。ModelBound 为你提供一个统一的位置来存储和管理 Agent 技能，让你可以自由切换工具，无需每次都重新搭建环境。只需编写一次技能，即可同步到各处，并让你已付费订阅的每个 AI 服务发挥更大价值。

功能介绍

modelbound-mcp 是一个小型的模型上下文协议服务，通过 stdio 在本地运行。它使用点号分隔的命名方式向 IDE / Agent 提供工具，便于浏览和发现：

本地（无需 API 密钥，无需联网）：

• ide.detectLayout — 检查代码库使用了哪些 IDE 约定
• skills.listLocal、skills.readLocal、skills.writeLocal
• skills.lint — 检查 front matter、token 数量、失效链接、TODO，以及通过 / 警告 / 失败检查（扫描器 h5）
• skills.flightCheck — Flight Check 离线安全扫描（注入、数据外泄、机密、破坏性命令、通配符工具、循环风险）；规则与 npx modelbound check 相同
• skills.checks — 执行确定性的安全 / 质量检查，无需完整 lint（不提供数值评分）
• skills.scaffold — 创建带默认范围限制的技能
• skills.reviewStatus、skills.reviewRequest、skills.reviewApprove、skills.reviewReject、skills.reviewGate
• skills.validateFormat — 检查是否符合 agentskills.io 规范
• skills.convert — 在不同 IDE 格式间转换（例如 Cursor → Claude）
• skills.diff — 比较本地技能与其云端版本

云端（需设置 MODELBOUND_API_KEY）：

• cloud.pullSkill、cloud.pushSkill、cloud.search
• cloud.listSkills — 现在支持 ai_type 和 source_platform 筛选；每行均包含 ai_type、source_platform、source_path 和 repo
• cloud.resourceTree — 返回团队的完整层级结构，按平台 → 顶层目录（.claude/skills、.cursor/rules、.kiro/steering 等）→ 文件分组。协调器需要在加载前映射上下文时，请先使用此工具，再调用 cloud.listSkills。
• cloud.installMarketplaceSkill
• optimization.health

资源层级结构

需要协调多个 AI 平台的协调器可以调用一次 cloud.resourceTree，获取可用技能、规则、钩子、steering 文件和系统提示词的完整映射——分组方式与各平台在磁盘上的预期结构完全一致。搭配 cloud.listSkills 新增的 ai_type / source_platform 筛选器，即可只加载所需部分。参见 examples/resource-tree.ts。

云端工具是面向 mcp.modelbound.co 的轻量级 JSON-RPC 代理。所有业务逻辑都在服务端运行；此代码库不会接触你的数据或机密。

从 0.1.x 迁移 — 旧的 snake_case 名称（detect_ide_layout、pull_skill 等）已于 0.2.0 移除。为保持向后兼容，托管的 ModelBound MCP 服务仍会永久接受这两种格式。

反臃肿（0.4.x） — 信任扫描器已升级至 h5，新增范围限制、无边界措辞、依赖项和重构问题检查。skills.readLocal 现在会返回 checks、scanner_version、review_state 和 review_meta。可通过 .modelbound/task-budgets.json 覆盖默认范围限制。在 CI 中使用 skills.reviewGate，阻止未经批准的技能通过。

安装

npx modelbound-mcp

或全局安装：

npm i -g modelbound-mcp

作为 MCP 服务使用

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "modelbound": {
      "command": "npx",
      "args": ["-y", "modelbound-mcp"],
      "env": { "MODELBOUND_API_KEY": "mb_live_..." }
    }
  }
}

MODELBOUND_API_KEY 是可选的。不提供此密钥时，本地工具仍可使用。

Claude Desktop、Kiro、Windsurf 和 VS Code 的配置请参阅 examples/。

作为命令行工具使用

modelbound-mcp detect                                  # which IDE layouts exist here?
modelbound-mcp ls                                      # list every skill file
modelbound-mcp lint .cursor/rules/                     # lint a directory
modelbound-mcp lint .codex/skills/                     # lint Codex skills
modelbound-mcp validate ./SKILL.md                     # agentskills.io compliance
modelbound-mcp convert --from cursor --to claude ./rule.mdc > out.md

测试

npm test              # unit tests (registry parity, checks, review, harness)
npm run smoke         # local MCP tools + CLI subcommands (+ cloud if MODELBOUND_API_KEY set)
npm run test:e2e      # offline anti-slop / review lifecycle

CLI 与 MCP 工具的对应关系：docs/PARITY.md。

贡献

我们欢迎大家参与。具体来说：

• 新增 IDE 适配器 — Zed、Aider、Continue、JetBrains AI、Cline。约 50 行的实现方法请参阅 CONTRIBUTING.md。
• Linter 规则 — 提高 token 估算准确性、检测失效链接、处理特定格式的注意事项。
• 格式转换器 — 改进适配器对之间的转换保真度。

浏览 适合新手的问题 和路线图。

相关项目

项目	说明
ModelBound CLI · npm	用于 token 优化、技能工作流和版本管理的终端工具 + CI
Cursor Extension · Marketplace	用于规则同步和 MCP 桥接的 VS Code/Cursor 扩展
Cursor Plugin	用于工作流、安全检查和版本管理的 Cursor 斜杠命令
Claude Code Plugin	用于工作流、钩子和技能同步的 Claude Code 插件
Dev Packs	面向工程团队的开源精选 AI 上下文包

也可在 Smithery（通过 npx modelbound-mcp 使用 stdio）和 MCP Registry 上找到。安装中心：modelbound.co/connect

许可证

MIT © ModelBound