Archrad Deterministic Mcp
@archradhq
stdio MCP server from @archrad/deterministic—same engine as the archrad CLI. Validates architecture IR (structural + IR-LINT), merges local PolicyPack YAML, checks export drift vs generated files on disk, and returns static archrad_suggest_fix guidance per built-in rule code. No
概览
What is Archrad Deterministic Mcp?
Archrad Deterministic Mcp gives AI coding agents (Claude Desktop, Cursor, and other MCP-capable hosts) deterministic architecture governance. It validates an intermediate representation (IR) against structural rules and built-in IR-LINT with no LLM in the validation loop, using the same engine as the archrad CLI. Licensed under Apache-2.0.
How to use Archrad Deterministic Mcp?
Install globally with npm install -g @archrad/deterministic; the binary archrad-mcp ships with the package. Alternatively, use npx without a global install by adding the server configuration to your MCP host (e.g., Claude Desktop's claude_desktop_config.json). The server exposes six MCP tools: archrad_validate_ir, archrad_lint_summary, archrad_validate_drift, archrad_policy_packs_load, archrad_suggest_fix, and archrad_list_rule_codes.
Key features of Archrad Deterministic Mcp
- Deterministic IR validation without LLM involvement
- Built-in IR-LINT rules for common architecture issues
- Drift detection between IR and on-disk export directories
- Optional PolicyPack support for custom governance rules
- Stateless per-call design; policies must be passed on each invocation
- Curated, static fix suggestions for individual rule codes
Use cases of Archrad Deterministic Mcp
- AI agents validating system graphs before code generation
- Pre-commit structural checks in CI/CD pipelines
- Comparing architecture IR against existing code exports for drift
- Smoke-checking PolicyPack YAML or JSON configurations
- Listing all built-in rule codes with static remediation guidance
FAQ from Archrad Deterministic Mcp
Does Archrad Deterministic Mcp use an LLM for validation?
No. The validation is fully deterministic, using the same engine as the archrad CLI. No AI is involved in rule evaluation.
What transport protocol does the server use?
The server uses standard MCP transport. For detailed transport options, IR size limits, and testing recipes, refer to the separate MCP.md documentation.
How are policies loaded and applied?
Policies are passed per-tool call via the policiesDirectory parameter. The archrad_policy_packs_load tool compiles and smoke-checks them but does not register them; they must be re-provided for each validation or lint call.
Can I use this with enterprise policy management?
Yes. For teams using ArchRad Cloud, a separate package (@archrad/remote-mcp) provides an HTTP MCP gateway that fetches org PolicyPack context using a bearer token. Deployment and token issuance are product-specific.
What are the runtime dependencies?
The server requires Node.js and the npm package @archrad/deterministic. It is tested with standard MCP hosts like Claude Desktop and Cursor. No additional databases or services are needed for the open-source version.
