archsteer — Claude Code MCP server
archsteer derives a project architecture model from source code, checks files, and gives agents target patterns. Use it to track rule drift.
claude mcp add archsteer -- uvx archsteerWhat archsteer does
archsteer creates a code-derived project model at .archsteer/model.json. Its MCP server exposes current_architecture, get_target_pattern, and check_file, so an agent can inspect the current structure, ask for the intended pattern, or validate one file. Repository analysis runs locally, and the first scan requires no account, API key, or configuration.
The CLI can scaffold .archsteer/, build the model, regenerate architecture docs and ADR drafts, score rule conformance, set a baseline, and run checks for CI or pre-commit use. Supported languages include JavaScript / TypeScript, Python, Java, and Salesforce Apex, with signals for Next.js App Router, Spring, and Apex conventions. The MCP setup depends on uvx being available, since the server is launched through that command.
archsteer can connect to Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI. In Claude Code, add it with claude mcp add archsteer -- uvx archsteer; the standalone CLI is installed with pip install archsteer.
What it helps with
- derive a dependency map from an existing codebase
- check a file against declared architecture rules
- regenerate living architecture documentation and ADR drafts
- set a baseline and reject new rule violations
- give an agent the intended pattern for a code change
Example prompts for the agent
- Show the current architecture and its main layer boundaries.
- Check
src/controllers/payment.jsagainst the project rules and explain the violations. - Tell me which target pattern to use for adding a service here.
How to install archsteer
Platform CLI
claude mcp add archsteer -- uvx archsteeruvx runs the command named after the package; if the README names another one, use uvx --from archsteer <command>
Platform CLI
codex mcp add archsteer -- uvx archsteeruvx runs the command named after the package; if the README names another one, use uvx --from archsteer <command>
Config file
{
"mcpServers": {
"archsteer": {
"command": "uvx",
"args": [
"archsteer"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from archsteer <command>
Config file
{
"servers": {
"archsteer": {
"type": "stdio",
"command": "uvx",
"args": [
"archsteer"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from archsteer <command>
Platform CLI
gemini mcp add archsteer uvx archsteeruvx runs the command named after the package; if the README names another one, use uvx --from archsteer <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about archsteer
How do I install archsteer in Claude Code?
Run claude mcp add archsteer -- uvx archsteer. This registers the archsteer MCP server with Claude Code.
What does archsteer do?
It derives an architecture model from source code, checks files against rules, and gives an agent current-architecture details and target patterns. The model is stored in .archsteer/model.json.
Which languages does archsteer support?
It supports JavaScript / TypeScript, Python, Java, and Salesforce Apex. It also recognizes conventions for Next.js App Router, Spring, and Apex.
