Cursor、Claude、VS Codeなどの複数のIDEにわたって、Agent Skillsファイルの検証、Lint、Diff、変換をAIクライアントから行えるようにします。
別名 ModelBound/modelbound-mcp-server, modelbound-mcp-server
- スター
- 1
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.2
- 最終コミット
- 2026年10月13日
- ライセンス
- MIT
ModelBound MCPとは
ModelBoundはMCPサーバーです。 Cursor、Claude、VS Codeなどの複数のIDEにわたって、Agent Skillsファイルの検証、Lint、Diff、変換をAIクライアントから行えるようにします。.
プロジェクトのREADMEから生成された概要
ModelBound MCP server について
modelbound-mcpは、Cursor、Claude、Windsurf、VS Codeなどのツールを使用する開発者が、異なるAI環境間でAgent Skillsを管理することを可能にします。このローカルファーストのMCP serverを使用すると、スキルファイルの検証、Lint、Diff、変換ができるため、ルールやコンテキストをプラットフォーム間でポータブルに保つことができます。stdio経由でローカルで動作し、基本的なローカル操作にはアカウントやAPIキーは必要ありません。
ユーザーはflightCheckツールを使用して、インジェクションのリスク、シークレット、または破壊的なコマンドを検出するためのオフライン・セーフティスキャンを実行できます。また、このサーバーは、IDE形式間でファイルを変換するskills.convertや、リンク切れやトークン数をチェックするskills.lintといった専用ツールも提供します。MODELBOUND_API_KEYを使用してオプションのクラウド同期を選択すると、cloud.pushSkill、cloud.pullSkill、cloud.searchを利用して、チームや複数のマシン間でスキルを管理できるようになります。
できること
- 1IDE間のスキル変換Cursor用に記述されたルールを、Claudeと互換性のある形式に変換します。
- 2オフライン・セーフティスキャンの実行flight checkを実行して、Agent Skillsに危険なコマンドやシークレットが含まれていないか確認します。
- 3スキルファイルのコンプライアンス検証スキルファイルがagentskills.ioのフォーマット標準に準拠しているか確認します。
- 4スキルをクラウドに同期APIキーを使用して、ローカルのAgentルールをリモートリポジトリにプッシュし、チームで共有できるようにします。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
ModelBound MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにModelBound MCPをインストール
$ claude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcpCursorにModelBound MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}VS CodeにModelBound MCPをインストール
.vscode/mcp.json
{
"servers": {
"modelbound-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}VS Code CLIにModelBound MCPをインストール
$ code --add-mcp '{"name":"modelbound-mcp-server","type":"stdio","command":"npx","args":["-y","modelbound-mcp"],"env":{"MODELBOUND_API_KEY":"<YOUR_MODELBOUND_API_KEY>"}}'Claude DesktopにModelBound MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}CodexにModelBound MCPをインストール
$ codex mcp add modelbound-mcp-server --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' -- npx -y modelbound-mcpCodex config.tomlにModelBound MCPをインストール
~/.codex/config.toml
[mcp_servers.modelbound-mcp-server] command = "npx" args = ["-y", "modelbound-mcp"] [mcp_servers.modelbound-mcp-server.env] MODELBOUND_API_KEY = "<YOUR_MODELBOUND_API_KEY>"
Gemini CLIにModelBound MCPをインストール
$ gemini mcp add -s user -e 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server npx -- -y modelbound-mcpGemini settings.jsonにModelBound MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}設定
MODELBOUND_API_KEYシークレットModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys
| 名前 | 説明 | 種類 |
|---|---|---|
| MODELBOUND_API_KEY | ModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys | シークレット |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能modelbound/modelbound-mcp-server is public and reachablegithub.com/modelbound/modelbound-mcp-server ↗合格
- パッケージがこのリポジトリをソースとして指定modelbound-mcp names modelbound/modelbound-mcp-server as sourcenpmjs.com/package/modelbound-mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-13github.com/modelbound/modelbound-mcp-server ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from modelbound-mcp合格
- パッケージおよびその依存関係に重大な勧告なし109 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るmodelbound-mcp
Local-first MCP server for agent skills. Validate, lint, diff, and convert agent skill files across Cursor, Claude, Codex, Kiro, Windsurf, VS Code, and Amazon Q — no account required. Optional cloud sync with ModelBound.
Why ModelBound?
AI tools come and go. You might use Cursor today, switch to Claude Code tomorrow, and try Kiro next week — but your skills, rules, and context shouldn't be locked into any one of them. ModelBound gives you a single place to store and manage your agent skills, so you can move between tools freely without rebuilding your setup each time. Write a skill once, sync it everywhere, and get more value out of every AI subscription you're already paying for.
What it does
modelbound-mcp is a small Model Context Protocol server you run locally over stdio. It exposes tools to your IDE / agent using dot-notation naming for navigable discovery:
Local (no API key, no network):
ide.detectLayout— find which IDE conventions your repo usesskills.listLocal,skills.readLocal,skills.writeLocalskills.lint— front-matter, token count, broken links, TODO scan, pass / warn / fail checks (scanner h5)skills.flightCheck— Flight Check offline safety scan (injection, exfiltration, secrets, destructive commands, wildcard tools, loop hazards); same rules asnpx modelbound checkskills.checks— deterministic safety/quality checks without full lint (no numeric score)skills.scaffold— create a skill with default scope constraintsskills.reviewStatus,skills.reviewRequest,skills.reviewApprove,skills.reviewReject,skills.reviewGateskills.validateFormat— agentskills.io complianceskills.convert— translate between IDE formats (e.g. Cursor → Claude)skills.diff— compare a local skill with its cloud counterpart
Cloud (with MODELBOUND_API_KEY):
cloud.pullSkill,cloud.pushSkill,cloud.searchcloud.listSkills— now acceptsai_typeandsource_platformfilters; every row includesai_type,source_platform,source_path, andrepocloud.resourceTree— returns the team's full hierarchy grouped by platform → top-level dir (.claude/skills,.cursor/rules,.kiro/steering, …) → files. Use this beforecloud.listSkillswhen an orchestrator needs to map context before loading.cloud.installMarketplaceSkilloptimization.health
Resource hierarchy
Orchestrators that juggle multiple AI platforms can call cloud.resourceTree once to get a complete map of available skills, rules, hooks, steering files, and system prompts — grouped exactly how each platform expects them on disk. Pair it with the new ai_type / source_platform filters on cloud.listSkills to load only the slice you need. See examples/resource-tree.ts.
The cloud tools are a thin JSON-RPC proxy to mcp.modelbound.co. All business logic stays server-side; this repo never touches your data or secrets.
Migration from 0.1.x — old snake_case names (
detect_ide_layout,pull_skill, …) were removed in 0.2.0. The hosted ModelBound MCP server still accepts both forms forever for backward compatibility.
Anti-slop (0.4.x) — trust scanner bumped to h5 with scope-limit, unbounded-wording, dependency, and refactor findings.
skills.readLocalnow returnschecks,scanner_version,review_state, andreview_meta. Override default scope limits via.modelbound/task-budgets.json. Useskills.reviewGatein CI to block unapproved skills.
Install
npx modelbound-mcp
Or install globally:
npm i -g modelbound-mcp
Use as an MCP server
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"modelbound": {
"command": "npx",
"args": ["-y", "modelbound-mcp"],
"env": { "MODELBOUND_API_KEY": "mb_live_..." }
}
}
}
MODELBOUND_API_KEY is optional. Without it, local tools still work.
See examples/ for Claude Desktop, Kiro, Windsurf, and VS Code configs.
Use as a 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
Tests
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 vs MCP tool mapping: docs/PARITY.md.
Contributing
We want help. Specifically:
- New IDE adapters — Zed, Aider, Continue, JetBrains AI, Cline. See CONTRIBUTING.md for the ~50 line recipe.
- Linter rules — token estimation accuracy, dead-link detection, format-specific gotchas.
- Format converters — fidelity improvements between adapter pairs.
Browse good first issues and the roadmap.
Related projects
| Project | Description |
|---|---|
| ModelBound CLI · npm | Terminal + CI for token optimization, skill pipeline, and version management |
| Cursor Extension · Marketplace | VS Code/Cursor extension for rules sync and MCP bridge |
| Cursor Plugin | Cursor slash commands for pipeline, safety checks, and versions |
| Claude Code Plugin | Claude Code plugin for pipeline, hooks, and skill sync |
| Dev Packs | Open-source curated AI context packs for engineering teams |
Also on Smithery (stdio via npx modelbound-mcp) and the MCP Registry. Install hub: modelbound.co/connect
License
MIT © ModelBound
ModelBound MCPのよくある質問
ModelBound MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
ModelBound MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
APIキーなしでModelBoundを使用できますか?
はい、ローカルツールはAPIキーなしで使用できますが、クラウド機能にはAPIキーが必要です。
どのIDEをサポートしていますか?
Cursor、Claude、Codex、Kiro、Windsurf、VS Code、Amazon Qをサポートしています。
異なるAIツール間でスキルを同期するにはどうすればよいですか?
ModelBoundを使用すると、スキルを一度記述するだけで異なるプラットフォーム間で同期できるため、特定のIDEに縛られるのを防げます。