Archy
by hslee16communityv0.13.3
1
2
Archy analyzes Python codebases by building a module-dependency graph and reporting structural health through scores, cycles, layer checks, contracts, hotspots, and impacted tests/modules. It can run as an MCP server to expose these checks to AI coding agents and supports caching plus agent installation for tools like Claude Code and Cursor.
From the registry: Architectural sensor for Python codebases.
Install & configure
Prerequisites
- required
- optionalInstall uv or pip/pipxInstall Archy via uv, pip, or pipx. The README recommends uv for the easiest MCP setup path.
https://docs.astral.sh/uv/$ pip install archy
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `archy` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Python 3.10+** — Archy requires Python 3.10 or newer. (https://pypi.org/project/archy/)
Optional prerequisites:
- Install uv or pip/pipx — Install Archy via uv, pip, or pipx. The README recommends uv for the easiest MCP setup path. Run: `pip install archy` (https://docs.astral.sh/uv/)
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["archy","mcp"]
Note: The README presents `archy mcp` as the MCP server entrypoint and explicitly states it uses stdio transport. For the most portable no-clone setup, prefer `uvx archy mcp`. Alternative install/run paths mentioned are `pip install archy` then `archy mcp`, `uv tool install archy`, or `pipx install archy`. No environment variables are required for the MCP server itself.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README presents `archy mcp` as the MCP server entrypoint and explicitly states it uses stdio transport. For the most portable no-clone setup, prefer `uvx archy mcp`. Alternative install/run paths mentioned are `pip install archy` then `archy mcp`, `uv tool install archy`, or `pipx install archy`. No environment variables are required for the MCP server itself.
Tools (15)
graph
Inspect the module dependency graph for a Python project.
cycles
Find import cycles, including self-loops.
check
Enforce layer rules from archy.yaml and fail on violations.
contracts
Enforce transitive import contracts via .importlinter or archy.yaml.
score
Compute a composite architectural quality score.
trend
Show score trends over time from recorded history.
hotspots
Find refactor priorities based on complexity and git churn.
what-to-refactor-next
Suggest refactor priorities by combining hotspots and edit risk.
affected
Given changed files, list impacted downstream modules and tests.
impact
List internal modules that transitively depend on a given file.
mcp
Run the MCP server exposing tools to MCP clients.
index sync
Build or refresh the persistent parse cache database.
index clear
Clear the persistent parse cache database.
Prerequisites
- • Python 3.10+
- • Python 3.9
Packages
archy
pypiv0.13.3transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- May 13, 2026
- Last commit
- Jun 10, 2026
- Registry name
- io.github.hslee16/archy
Categories
Related Servers
Labelhead Artist Momentum
Trending hip-hop artist momentum scores across four cultural dimensions.
74.9k
PostHog MCP Server
Official PostHog MCP Server for product analytics, feature flags, experiments, and more.
37.3k
Openmetadata Mcp
Official OpenMetadata MCP: governed context and business semantics for AI assistants and agents.
14.6k