Impose des limites architecturales et fournit le contexte de projet pour les agents de codage IA dans les bases de code JavaScript et TypeScript.
Aussi connu sous codapult/codapult-guard, codapult-guard, @codapult/guard
- Étoiles
- 4
- Outils
- —
- Téléchargements, 30 jours
- 3 407
- Dernière version
- 0.14.1
- Dernier commit
- 10 nov. 2026
- Licence
- MIT
Qu'est-ce que Guard MCP ?
Guard est un serveur MCP. Impose des limites architecturales et fournit le contexte de projet pour les agents de codage IA dans les bases de code JavaScript et TypeScript.
Résumé généré à partir du README du projet
À propos du MCP server Guard
Le maintien de l'intégrité architecturale dans les bases de code JavaScript et TypeScript est ce que guard permet aux équipes de développement. Il cartographie la structure spécifique de votre projet pour identifier les dépendances et les limites, vous permettant d'approuver des règles personnalisées qui empêchent les imports illégaux ou les régressions structurelles. Contrairement aux vérificateurs de types standards, il comprend les exigences spécifiques au projet, comme le maintien de la séparation entre les composants clients et les modules de persistance.
Les développeurs utilisent cet outil localement ou dans des environnements CI comme GitHub en utilisant des préréglages pour les pull requests ou les files d'attente de fusion. Le MCP server fonctionne via le stdio local géré par l'hôte, ce qui signifie qu'il ne nécessite ni écouteur réseau ni authentification au niveau de l'application. Il fonctionne aux côtés des outils existants comme ESLint, Biome ou TypeScript plutôt que de les remplacer. Pour l'intégrer à un agent IA, vous pouvez utiliser la commande install-agent pour fournir le contexte nécessaire à la vérification.
En fournissant des résultats déterministes via CLI, JSON et SARIF, il garantit que les agents de codage IA reçoivent le même contexte architectural et les mêmes conclusions de vérification que les développeurs humains. Cela aide à empêcher les agents d'introduire des changements qui violent vos contrats de projet établis.
Ce que vous pouvez faire avec
- 1Prévenir les régressions architecturalesDemandez à l'IA de vérifier si un nouvel import viole les limites établies du projet.
- 2Fournir un contexte architectural aux agentsDonnez à un agent IA la structure du projet et les règles approuvées pour qu'il respecte vos modèles de conception spécifiques.
- 3Automatiser les revues de pull requestConfigurez des vérifications automatisées pour vous assurer que chaque pull request respecte vos contrats architecturaux.
- 4Analyser l'impact des changementsUtilisez l'outil pour comprendre comment un changement de code affecte la structure existante du projet.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Guard MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Guard MCP dans Claude Code
$ claude mcp add codapult-guard -- npx -y @codapult/guardInstaller Guard MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"codapult-guard": {
"command": "npx",
"args": [
"-y",
"@codapult/guard"
]
}
}
}Installer Guard MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"codapult-guard": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codapult/guard"
]
}
}
}Installer Guard MCP dans VS Code CLI
$ code --add-mcp '{"name":"codapult-guard","type":"stdio","command":"npx","args":["-y","@codapult/guard"]}'Installer Guard MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"codapult-guard": {
"command": "npx",
"args": [
"-y",
"@codapult/guard"
]
}
}
}Installer Guard MCP dans Codex
$ codex mcp add codapult-guard -- npx -y @codapult/guardInstaller Guard MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.codapult-guard] command = "npx" args = ["-y", "@codapult/guard"]
Installer Guard MCP dans Gemini CLI
$ gemini mcp add -s user codapult-guard npx -- -y @codapult/guardInstaller Guard MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"codapult-guard": {
"command": "npx",
"args": [
"-y",
"@codapult/guard"
]
}
}
}Vérifications automatisées
Exécuté le 14 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 accessiblecodapult/codapult-guard is public and reachablegithub.com/codapult/codapult-guard ↗Réussi
- Le nom du package correspond au dépôt source@codapult/guard names codapult/codapult-guard as sourcenpmjs.com/package/@codapult/guard ↗Réussi
- Provenance du build (attestation Sigstore)Sigstore attestation for @codapult/guardnpmjs.com/package/@codapult/guard/v/0.14.1#provenance ↗Réussi
- 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-11-10github.com/codapult/codapult-guard ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @codapult/guardRéussi
- Aucun avis critique dans le package ou ses dépendances115 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 GitHub@codapult/guard
Architecture guardrails for AI-assisted development
Codapult Guard helps teams preserve the architecture that makes their project work as it changes. It maps a JavaScript or TypeScript codebase, lets the team approve project-specific boundaries, and checks future changes locally and in CI. AI agents can use the same project context and verification results as developers.
Catch project-specific regressions
A type checker can confirm that code is valid TypeScript. It cannot know that this project requires client components to stay away from persistence modules. Once the team approves that boundary, Guard can detect a violating import in changed files and show which rule was triggered.
Project boundary: Client → Server Action → Service → Repository → Database
Possible regression: Client ─────────────────────────────────────→ Database
Guard discovers the architecture in the repository; it does not prescribe one universal structure or activate proposed rules without approval.
Get started
Requirements: Node.js >=20.19 and a JavaScript or TypeScript project.
# pnpm
pnpm add -D @codapult/guard
pnpm exec codapult-guard init
# npm
npm install --save-dev @codapult/guard
npx codapult-guard init
Review the generated project model, proposed rules, contracts, and baseline under
.codapult/guard/ before relying on the results. Then run Guard's architecture checks:
pnpm exec codapult-guard verify --no-project-checks --tools off
verify can run your configured project checks and detected adapters. The flags above limit this
run to Guard's built-in checks. With npm, run npx codapult-guard verify --no-project-checks --tools off.
See the complete guide for initialization and daily workflows.
Use Guard with an AI agent
Install a managed instruction block for your agent so it knows when to load Guard context and run verification:
pnpm exec codapult-guard install-agent codex
Supported hosts and MCP setup are in the AI-agent integration guide and host integration guides.
The MCP server uses host-managed local stdio, with no network listener or application-level authentication. The host and operating system control process access and workspace permissions; see the security model.
Choose a GitHub setup
Choose a preset from the existing workflow templates and follow only the hosting steps for that level of protection. Most projects can start with standard PR checks.
| Preset | Use it when | Guide |
|---|---|---|
| PR checks | You want Guard findings and a required check on ordinary pull requests. | GitHub PR checks |
| Trusted PR verification | The Guard check must come from a protected workflow source, including for fork PRs. | Trusted PR setup |
| Merge queue | Your repository merges through a GitHub merge queue. | Merge queue setup |
If you are unsure, use PR checks first. It is useful CI feedback, but its workflow lives in the project being checked and can be changed by a pull request. Choose trusted verification when the check itself must be protected from that change.
What Guard does
- Learns project-specific structure, dependencies, boundaries, and existing findings.
- Checks approved architecture rules and contracts without imposing a universal architecture.
- Shows change impact and prepares bounded, redacted context for AI review.
- Runs configured project checks and adapters when enabled; it does not replace them.
- Produces deterministic CLI, JSON, and SARIF results for local use and CI.
Guard is local-first and does not call an LLM. The AI host owns model access, edits, and its repair loop. Guard complements TypeScript, ESLint or Biome, tests, SAST, and dependency scanners; it does not replace them.
Documentation
- GitHub setup presets — choose and configure the CI level you need.
- Complete Guard guide — commands, policy, results, security, and advanced workflows.
- AI-agent integration — managed instructions and MCP workflow.
- Host integrations — Codex, Cursor, Claude Code, Copilot, Gemini CLI, and generic MCP clients.
- Policy mutation controls — approval and protected policy behavior.
- Extensions — adapters, output formats, and integration boundaries.
For contributors
Maintainer checks and project fixture coverage are documented in the fixture guide and release guide.
More from Codapult
Starting a SaaS from scratch? Codapult is a production-ready Next.js SaaS foundation built for AI-assisted development, with modular architecture, built-in AI, MCP context, and source code under your control.
License
MIT. See LICENSE.
Questions sur Guard MCP
Comment ajouter Guard MCP à Claude Code ?
Exécutez claude mcp add codapult-guard -- npx -y @codapult/guard dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Guard 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.
Comment Guard empêche-t-il les régressions architecturales ?
Il permet aux équipes d'approuver des limites spécifiques au projet et détecte les imports non conformes dans les fichiers modifiés lorsqu'une règle est déclenchée.
Guard utilise-t-il un LLM pour vérifier le code ?
Non, Guard est conçu en local-first et n'appelle pas de LLM ; l'hôte IA est responsable de l'accès au modèle et des modifications.
Quels sont les prérequis système pour Guard ?
Vous avez besoin de Node.js version 20.19 ou supérieure et d'un projet JavaScript ou TypeScript.
Comment le MCP server gère-t-il l'authentification ?
Le MCP server utilise le stdio local géré par l'hôte et n'utilise pas d'écouteurs réseau ni d'authentification au niveau de l'application.