Permet à un client IA de valider, linter, comparer et convertir des fichiers de compétences d'agent (agent skills) sur plusieurs IDE tels que Cursor, Claude et VS Code.
Aussi connu sous ModelBound/modelbound-mcp-server, modelbound-mcp-server
- Étoiles
- 1
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.2
- Dernier commit
- 13 oct. 2026
- Licence
- MIT
Qu'est-ce que ModelBound MCP ?
Permet à un client IA de valider, linter, comparer et convertir des fichiers de compétences d'agent (agent skills) sur plusieurs IDE tels que Cursor, Claude et VS Code.
Résumé généré à partir du README du projet
À propos du MCP server ModelBound
La gestion des agent skills à travers différents environnements d'IA est ce que modelbound-mcp permet aux développeurs utilisant des outils comme Cursor, Claude, Windsurf et VS Code. Ce MCP server local-first vous permet de valider, linter, comparer et convertir des fichiers de compétences afin que vos règles et votre contexte restent portables entre les plateformes. Il s'exécute localement via stdio et ne nécessite ni compte ni clé API pour les opérations locales de base.
Les utilisateurs peuvent effectuer des scans de sécurité hors ligne en utilisant l'outil flightCheck pour détecter les risques d'injection, les secrets ou les commandes destructrices. Le serveur propose également des outils spécialisés comme skills.convert pour traduire des fichiers entre les formats d'IDE et skills.lint pour vérifier les liens rompus ou le nombre de tokens. Si vous choisissez d'utiliser la synchronisation cloud optionnelle avec une MODELBOUND_API_KEY, vous accédez à cloud.pushSkill, cloud.pullSkill et cloud.search pour gérer vos compétences au sein d'une équipe ou sur plusieurs machines.
Ce que vous pouvez faire avec
- 1Convertir des compétences entre IDETraduire une règle écrite pour Cursor dans un format compatible avec Claude.
- 2Effectuer des scans de sécurité hors ligneLancer un flight check pour s'assurer que vos agent skills ne contiennent pas de commandes dangereuses ou de secrets.
- 3Valider la conformité des fichiers de compétencesVérifier si vos fichiers de compétences respectent les standards de formatage d'agentskills.io.
- 4Synchroniser les compétences vers le cloudPousser vos règles d'agent locales vers un dépôt distant pour un accès en équipe en utilisant une clé API.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer ModelBound MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller ModelBound MCP dans Claude Code
$ claude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcpInstaller ModelBound MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}Installer ModelBound MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"modelbound-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}Installer ModelBound MCP dans VS Code CLI
$ code --add-mcp '{"name":"modelbound-mcp-server","type":"stdio","command":"npx","args":["-y","modelbound-mcp"],"env":{"MODELBOUND_API_KEY":"<YOUR_MODELBOUND_API_KEY>"}}'Installer ModelBound MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}Installer ModelBound MCP dans Codex
$ codex mcp add modelbound-mcp-server --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' -- npx -y modelbound-mcpInstaller ModelBound MCP dans Codex config.toml
~/.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>"
Installer ModelBound MCP dans Gemini CLI
$ gemini mcp add -s user -e 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server npx -- -y modelbound-mcpInstaller ModelBound MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}Configuration
MODELBOUND_API_KEYSecretModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys
| Nom | Description | Type |
|---|---|---|
| MODELBOUND_API_KEY | ModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys | Secret |
Vérifications automatisées
Exécuté le 13 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblemodelbound/modelbound-mcp-server is public and reachablegithub.com/modelbound/modelbound-mcp-server ↗Réussi
- Le nom du package correspond au dépôt sourcemodelbound-mcp names modelbound/modelbound-mcp-server as sourcenpmjs.com/package/modelbound-mcp ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-10-13github.com/modelbound/modelbound-mcp-server ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from modelbound-mcpRéussi
- Aucun avis critique dans le package ou ses dépendances109 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur GitHubmodelbound-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
Questions sur ModelBound MCP
Comment ajouter ModelBound MCP à Claude Code ?
Exécutez claude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter ModelBound MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Puis-je utiliser ModelBound sans clé API ?
Oui, les outils locaux fonctionnent sans clé API, bien que les fonctionnalités cloud en nécessitent une.
Quels IDE sont pris en charge ?
Il prend en charge Cursor, Claude, Codex, Kiro, Windsurf, VS Code et Amazon Q.
Comment puis-je synchroniser mes compétences entre différents outils d'IA ?
ModelBound vous permet d'écrire une compétence une seule fois et de la synchroniser sur différentes plateformes pour éviter d'être lié à un seul IDE.