Ermöglicht es einem AI-Client, Agent Skill Files über mehrere IDEs wie Cursor, Claude und VS Code hinweg zu validieren, zu linten, zu diffen und zu konvertieren.
Auch bekannt als ModelBound/modelbound-mcp-server, modelbound-mcp-server
- Stars
- 1
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.2
- Letzter Commit
- 13. Okt. 2026
- Lizenz
- MIT
Was ist ModelBound MCP?
ModelBound ist ein MCP server. Ermöglicht es einem AI-Client, Agent Skill Files über mehrere IDEs wie Cursor, Claude und VS Code hinweg zu validieren, zu linten, zu diffen und zu konvertieren.
Zusammenfassung generiert aus dem README des Projekts
Über ModelBound MCP server
Das Management von Agent Skills über verschiedene AI-Umgebungen hinweg ist das, was modelbound-mcp für Entwickler ermöglicht, die Tools wie Cursor, Claude, Windsurf und VS Code nutzen. Dieser Local-first MCP server erlaubt es dir, Skill Files zu validieren, zu linten, zu diffen und zu konvertieren, damit deine Regeln und dein Kontext zwischen den Plattformen portabel bleiben. Er läuft lokal über stdio und benötigt für grundlegende lokale Operationen weder ein Konto noch einen API-Key.
Nutzer können Offline-Sicherheitsscans mit dem flightCheck Tool durchführen, um Injection-Risiken, Secrets oder destruktive Commands zu erkennen. Der Server bietet zudem spezialisierte Tools wie skills.convert, um Dateien zwischen IDE-Formaten zu übersetzen, und skills.lint, um defekte Links oder Token-Counts zu prüfen. Wenn du dich entscheidest, den optionalen Cloud-Sync mit einem MODELBOUND_API_KEY zu nutzen, erhältst du Zugriff auf cloud.pushSkill, cloud.pullSkill und cloud.search, um deine Skills in einem Team oder auf mehreren Maschinen zu verwalten.
Was du damit machen kannst
- 1Skills zwischen IDEs konvertierenÜbersetze eine Regel, die für Cursor geschrieben wurde, in ein Format, das mit Claude kompatibel ist.
- 2Offline-Sicherheitsscans durchführenFühre einen flight check aus, um sicherzustellen, dass deine Agent Skills keine gefährlichen Commands oder Secrets enthalten.
- 3Skill-File-Compliance validierenPrüfe, ob deine Skill Files den Formatierungsstandards von agentskills.io entsprechen.
- 4Skills in die Cloud synchronisierenPushe deine lokalen Agent Rules mithilfe eines API-Keys in ein Remote-Repository für den Teamzugriff.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du ModelBound MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenModelBound MCP in Claude Code installieren
$ claude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcpModelBound MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}ModelBound MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"modelbound-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}ModelBound MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"modelbound-mcp-server","type":"stdio","command":"npx","args":["-y","modelbound-mcp"],"env":{"MODELBOUND_API_KEY":"<YOUR_MODELBOUND_API_KEY>"}}'ModelBound MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}ModelBound MCP in Codex installieren
$ codex mcp add modelbound-mcp-server --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' -- npx -y modelbound-mcpModelBound MCP in Codex config.toml installieren
~/.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>"
ModelBound MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server npx -- -y modelbound-mcpModelBound MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}Konfiguration
MODELBOUND_API_KEYSecretModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys
| Name | Beschreibung | Typ |
|---|---|---|
| MODELBOUND_API_KEY | ModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys | Secret |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarmodelbound/modelbound-mcp-server is public and reachablegithub.com/modelbound/modelbound-mcp-server ↗Bestanden
- Paket nennt dieses Repository als Quellemodelbound-mcp names modelbound/modelbound-mcp-server as sourcenpmjs.com/package/modelbound-mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-13github.com/modelbound/modelbound-mcp-server ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from modelbound-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten109 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenmodelbound-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 Fragen
Wie füge ich ModelBound MCP zu Claude Code hinzu?
Führe claude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich ModelBound MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Kann ich ModelBound ohne API-Key nutzen?
Ja, die lokalen Tools funktionieren ohne API-Key, wobei Cloud-Features einen erfordern.
Welche IDEs werden unterstützt?
Es werden Cursor, Claude, Codex, Kiro, Windsurf, VS Code und Amazon Q unterstützt.
Wie kann ich meine Skills über verschiedene AI-Tools hinweg synchronisieren?
ModelBound erlaubt es dir, einen Skill einmal zu schreiben und ihn über verschiedene Plattformen hinweg zu synchronisieren, um einen Vendor Lock-in bei einer IDE zu vermeiden.