Cursor, Claude ve VS Code gibi birden fazla IDE üzerinde agent skill dosyalarını doğrulamanıza, lint etmenize, diff karşılaştırması yapmanıza ve dönüştürmenize olanak tanır.
Ayrıca bilinen adı ModelBound/modelbound-mcp-server, modelbound-mcp-server
- Yıldızlar
- 1
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.2
- Son commit
- 13 Eki 2026
- Lisans
- MIT
ModelBound MCP nedir?
ModelBound bir MCP sunucusudur. Cursor, Claude ve VS Code gibi birden fazla IDE üzerinde agent skill dosyalarını doğrulamanıza, lint etmenize, diff karşılaştırması yapmanıza ve dönüştürmenize olanak tanır.
Özet, projenin README dosyasından oluşturuldu
ModelBound MCP sunucusu hakkında
modelbound-mcp; Cursor, Claude, Windsurf ve VS Code gibi araçlar kullanan geliştiricilerin, farklı AI ortamlarındaki agent skill dosyalarını yönetmesini sağlar. Bu yerel öncelikli MCP server, kurallarınızın ve bağlamınızın platformlar arasında taşınabilir kalması için skill dosyalarını doğrulamanıza, lint etmenize, diff karşılaştırması yapmanıza ve dönüştürmenize olanak tanır. stdio üzerinden yerel olarak çalışır ve temel yerel işlemler için bir hesap veya API anahtarı gerektirmez.
Kullanıcılar, enjeksiyon risklerini, gizli bilgileri veya yıkıcı komutları tespit etmek için flightCheck aracını kullanarak çevrimdışı güvenlik taramaları gerçekleştirebilirler. Sunucu ayrıca, dosyaları IDE formatları arasında çevirmek için skills.convert ve bozuk bağlantıları veya token sayılarını kontrol etmek için skills.lint gibi özelleşmiş araçlar sağlar. MODELBOUND_API_KEY ile isteğe bağlı bulut senkronizasyonunu kullanmayı seçerseniz, skill dosyalarınızı bir ekip veya birden fazla makine arasında yönetmek için cloud.pushSkill, cloud.pullSkill ve cloud.search özelliklerine erişim sağlarsınız.
Neler yapabilirsiniz
- 1IDE'ler arası skill dönüştürmeCursor için yazılmış bir kuralı Claude ile uyumlu bir formata dönüştürün.
- 2Çevrimdışı güvenlik taramaları yapmaAgent skill dosyalarınızın tehlikeli komutlar veya gizli bilgiler içermediğinden emin olmak için bir flight check çalıştırın.
- 3Skill dosyası uyumluluğunu doğrulamaSkill dosyalarınızın agentskills.io format standartlarına uygun olup olmadığını kontrol edin.
- 4Skill dosyalarını buluta senkronize etmeYerel agent kurallarınızı, bir API anahtarı kullanarak ekip erişimi için uzak bir depoya gönderin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
ModelBound MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleModelBound MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcpModelBound MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}ModelBound MCP'yi VS Code içine yükleyin
.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'yi VS Code CLI içine yükleyin
$ 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'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}ModelBound MCP'yi Codex içine yükleyin
$ codex mcp add modelbound-mcp-server --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' -- npx -y modelbound-mcpModelBound MCP'yi Codex config.toml içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server npx -- -y modelbound-mcpModelBound MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"modelbound-mcp-server": {
"command": "npx",
"args": [
"-y",
"modelbound-mcp"
],
"env": {
"MODELBOUND_API_KEY": "<YOUR_MODELBOUND_API_KEY>"
}
}
}
}Yapılandırma
MODELBOUND_API_KEYGizliModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys
| Ad | Açıklama | Sunucu |
|---|---|---|
| MODELBOUND_API_KEY | ModelBound API key for optional cloud sync features. Get one at https://modelbound.co/settings/api-keys | Gizli |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirmodelbound/modelbound-mcp-server is public and reachablegithub.com/modelbound/modelbound-mcp-server ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyormodelbound-mcp names modelbound/modelbound-mcp-server as sourcenpmjs.com/package/modelbound-mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-13github.com/modelbound/modelbound-mcp-server ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from modelbound-mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok109 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
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 soruları
ModelBound MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'MODELBOUND_API_KEY=<YOUR_MODELBOUND_API_KEY>' modelbound-mcp-server -- npx -y modelbound-mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
ModelBound MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
ModelBound'u bir API anahtarı olmadan kullanabilir miyim?
Evet, yerel araçlar bir API anahtarı olmadan çalışır ancak bulut özellikleri için bir anahtar gereklidir.
Hangi IDE'leri destekliyor?
Cursor, Claude, Codex, Kiro, Windsurf, VS Code ve Amazon Q desteklemektedir.
Skill dosyalarımı farklı AI araçları arasında nasıl senkronize edebilirim?
ModelBound, bir skill dosyasını bir kez yazmanıza ve tek bir IDE'ye bağlı kalmamak için farklı platformlar arasında senkronize etmenize olanak tanır.