modelbound-mcp

modelbound-mcp

エージェントスキル向けのローカル優先型 MCP サーバーです。Cursor、Claude、Codex、Kiro、Windsurf、VS Code、Amazon Q のスキルファイルを検証、リント、差分比較、変換できます。アカウントは不要です。ModelBound とのクラウド同期も任意で利用できます。

ModelBound を選ぶ理由

AI ツールは次々と登場します。今日は Cursor を使い、明日は Claude Code に切り替え、来週には Kiro を試すかもしれません。しかし、スキル、ルール、コンテキストを特定のツールだけに縛られるべきではありません。ModelBound では、エージェントスキルを一元的に保存、管理できるため、セットアップを毎回作り直すことなく、ツール間を自由に移行できます。スキルを一度作成して、あらゆる場所に同期すれば、すでに利用料金を支払っている AI サブスクリプションをもっと有効活用できます。

できること

modelbound-mcp は、stdio 経由でローカル実行する小型のモデルコンテキストプロトコル サーバーです。ナビゲートしやすい探索を可能にする ドット記法の命名で、IDE／エージェントにツールを公開します。

ローカル（API キー不要、ネットワーク不要）：

• ide.detectLayout — リポジトリで使われている IDE の規約を検出します
• skills.listLocal、skills.readLocal、skills.writeLocal
• skills.lint — フロントマター、トークン数、リンク切れ、TODO のスキャン、合格／警告／不合格のチェック（スキャナー h5）
• skills.flightCheck — Flight Check オフライン安全性スキャン（インジェクション、データ流出、シークレット、破壊的コマンド、ワイルドカードツール、ループの危険性）。npx modelbound check と同じルールです
• skills.checks — 完全なリントを実行せずに行う、決定論的な安全性／品質チェック（数値スコアなし）
• 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 を一度呼び出すだけで、利用可能なスキル、ルール、フック、ステアリングファイル、システムプロンプトの全体像を取得できます。各プラットフォームがディスク上で想定する構成に合わせてグループ化されます。新しい 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/ をご覧ください。

CLI として使用する

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。CONTRIBUTING.md で約 50 行の手順をご覧ください。
• リンタールール — トークン推定の精度、デッドリンクの検出、形式固有の注意点。
• 形式コンバーター — アダプター間の変換精度の向上。

初めての方におすすめの Issue とロードマップをご覧ください。

関連プロジェクト

プロジェクト	説明
ModelBound CLI · npm	トークン最適化、スキルパイプライン、バージョン管理のためのターミナルツールおよび 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