Archrad Deterministic Mcp

Name: Archrad Deterministic Mcp
Author: archradhq

@archradhq

关于 Archrad Deterministic Mcp

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

#architecture-as-code #validation #ir #lint #policy #mcp #cursor #claude #devops #openapi #codegen #deterministic #apache-2-0

基本信息

分类

开发工具

传输方式

stdio

发布者

archradhq

提交者

Archrad

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "archrad": {
      "command": "npx",
      "args": [
        "-y",
        "--package=@archrad/deterministic",
        "archrad-mcp"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.