architecture-contract
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
@godrix/architecture-contract-mcp
Architecture Contract MCP (ARC) — agnostic MCP server that reads arc.yaml from the workspace and exposes tools to map layers, trace slices, generate scaffolding, and validate architectural rules.
MCP server name:
@godrix/architecture-contract-mcpBinary:
architecture-contract-mcpTool prefix:
arc_*(unchanged)Node: 20+
Quick install (npx)
No clone or local build required — the published npm package includes compiled JavaScript.
Cursor / Claude Desktop (mcp.json)
{
"mcpServers": {
"architecture-contract": {
"command": "npx",
"args": ["-y", "@godrix/architecture-contract-mcp"],
"env": {}
}
}
}Restart your MCP client after saving. Or use the Install MCP Server button above.
Global install (alternative)
npm install -g @godrix/architecture-contract-mcpThen use "command": "architecture-contract-mcp" in mcp.json.
Related MCP server: boilerforge
Local development
git clone https://github.com/godrix/mcp-architecture-contract.git
cd mcp-architecture-contract
npm install
npm run build{
"mcpServers": {
"architecture-contract": {
"command": "node",
"args": ["/absolute/path/mcp-architecture-contract/dist/index.js"],
"env": {}
}
}
}CLI (CI/local)
# Validate manifest + rules (+ validators if configured)
node dist/index.js validate --workspace /path/to/project
node dist/index.js validate --workspace /path/to/project --run-validators
# Scaffold dry-run (default) or write
node dist/index.js scaffold --kind rest_endpoint --name Foo --workspace /path/to/project
node dist/index.js scaffold --kind rest_endpoint --name Foo --workspace /path/to/project --writeOr via bin:
architecture-contract-mcp validate --workspace /path/to/project
architecture-contract-mcp scaffold --kind rest_endpoint --name Foo --writeExit code 1 when there are error violations or a validator fails.
Local plugins
Custom architectures live under .arc/plugins/{id}/:
my-project/
arc.yaml
.arc/plugins/my-arch/
manifest.yaml
templates/
UseCase.java.hbs# arc.yaml (thin — default from arc_init)
schemaVersion: "1"
extends: ./.arc/plugins/my-arch/manifest.yaml
project:
name: my-service
language: java
rootPackage: com.example.myappextends accepts:
Built-in preset:
hexagonal-java@1Local file:
./.arc/plugins/my-arch/manifest.yaml
Template priority: .arc/templates/ (project) → plugin/templates/ → built-in preset.
Create an editable plugin from a preset:
{
"tool": "arc_init_plugin",
"arguments": {
"pluginId": "my-arch",
"preset": "hexagonal-java@1",
"workspaceRoot": "/path/to/project"
}
}MCP tools
Tool | Description |
| Effective manifest + extendsRef, pluginRoots, kindSummaries |
| Rules, layers, docs and examples per layer |
| Files to create ( |
| Search with score; |
| Slice or inferred chain (find + imports) |
| Generate Handlebars files ( |
| Expected diff vs disk |
| Rules + mayDependOn/mustNotDependOn + CLI validators |
| Validate arc.yaml and plugins against schema |
| Create thin arc.yaml (default) or |
| Create |
| List built-in presets |
| List local plugins |
| Steps/templates for a kind |
| Layer + rules + repo examples |
| Register slice in arc.yaml |
| Mermaid graph of layers + violations |
| Expected path for |
MCP resources
arc://guide— full guide (SKILL + README)arc://manifest/effective— merged manifest (JSON)arc://rules— layers + rulesarc://plugins— plugins in.arc/plugins/arc://plugin/{id}— manifest and templates for a plugin
Prompts
arc-scaffold-workflow— load → resolve → confirm → scaffoldarc-init-plugin— create plugin in.arc/plugins/{id}/arc-validate-workflow— validate manifest and compliance
Recommended workflow
arc_initorarc_init_plugin+ localextendsarc_load→ profile, kinds, pluginRootsarc_resolve(orarc_diff_scaffold) withkind+nameConfirm with the user
arc_scaffoldwithdryRun: falsearc_validateafter changes
Built-in presets
hexagonal-java@1— Spring hexagonal (port.in/out, adapters, domain)mvc-typescript@1— controllers, services, apifsd-react@1— Feature-Sliced Design (app, pages, widgets, features, entities, shared)
arc.yaml schema (v1)
arc_init writes to the project:
.arc/arc-manifest.schema.json— manifest JSON Schema.arc/schema.json— alias ($ref) for lint toolsthin
arc.yamlwithextends(or full withmode: full)
# yaml-language-server: $schema=./.arc/arc-manifest.schema.json
schemaVersion: "1"
parent: optional/path/to/parent/arc.yaml
extends: preset-id@version | ./.arc/plugins/id/manifest.yaml
project:
name: string
language: java | typescript | kotlin | other
rootPackage: optional
sourceRoot: "."
profile: hexagonal | mvc | fsd | custom
layers:
- id: string
path: glob
suffix: optional
mayDependOn: [layerIds]
mustNotDependOn: [layerIds]
kinds:
<kindId>:
variables: { key: description }
steps:
- manual: string
- generate: { layer, template, namingKey? }
rules:
- id: string
when: { layer: string | string[] }
forbidImports: [glob/substring]
requireSuffix: string
severity: error | warn
message: stringTests
npm testMCP Inspector
npm run build
npx @modelcontextprotocol/inspector node dist/index.jsMigration from arc-mcp
Before | After |
npm package |
|
Folder |
|
bin |
|
MCP server name |
|
Tool names | unchanged |
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
ArcAgent MCP server for bounty discovery, workspace execution, and verified coding submissions.
An MCP server for Arcjet - the runtime security platform that ships with your AI code.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceMCP server that exposes code tracing capabilities including journey flows, HTTP seams, and findings from indexed projects, allowing AI assistants to query software architecture.-
- AlicenseAqualityDmaintenanceArchitecture governance MCP server for AI-built codebases, enabling health checks, template management, and project scaffolding with migration support.54 npmMIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that provides a shared graph of an organization's projects, processes, areas, and principles, enabling consistent context for tools and AI agents.2Apache 2.0
- FlicenseAqualityDmaintenanceMCP server for repository mapping, dependency analysis, and architecture diagram generation for JavaScript, TypeScript, and Python projects.410 npm-