archy — Claude Code MCP server: what it does, how to install
Python architecture sensor that tracks import graphs, catches cycles, and pinpoints tests affected before making code edits.
claude mcp add archy -- uvx archyWhat archy does
The server builds and caches an internal graph of Python imports and call paths. It resolves architectural questions an ordinary file tree obscures. Before applying changes, it maps the transitive reach of an edit, spots cycle traps between modules, and pinpoints relevant test suites.
Beyond impact analysis, archy verifies directional layer constraints. When an import flows the wrong way, such as core entities importing data access layers directly, checks fail immediately. The tool targets Python codebases specifically and expects uvx in the environment to launch.
What it helps with
- map blast radius across Python modules before editing
- identify which test suites touch changed code
- detect import cycles across the repository
- enforce directional architectural boundaries between layers
Example prompts for the agent
- Check which tests I should run after modifying
core/models.py - Find any circular imports across the project before we commit
- Map out which modules are affected if I edit the data access layer
How to install archy
Platform CLI
claude mcp add archy -- uvx archyuvx runs the command named after the package; if the README names another one, use uvx --from archy <command>
Platform CLI
codex mcp add archy -- uvx archyuvx runs the command named after the package; if the README names another one, use uvx --from archy <command>
Config file
{
"mcpServers": {
"archy": {
"command": "uvx",
"args": [
"archy"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from archy <command>
Config file
{
"servers": {
"archy": {
"type": "stdio",
"command": "uvx",
"args": [
"archy"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from archy <command>
Platform CLI
gemini mcp add archy uvx archyuvx runs the command named after the package; if the README names another one, use uvx --from archy <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 archy
How to install archy in Claude Code?
Run claude mcp add archy -- uvx archy in your terminal. You need uv available on your system to run the command.
What does archy do?
It indexes Python imports and function calls into a cached graph to trace edit blast radius, find relevant tests, and catch layer violations.
Which programming languages does archy support?
It inspects Python codebases only.
