io.github.hslee16/archy

archy

Architectural sensor for Python codebases.

1 8 tools GitHub PyPI

No known CVEs

No license

Actively maintained

Last commit 7d ago

Works with most clients

Transport: stdio, sse, http

8 tools · ~655 tok

Grade B · 0.3% of 200K ctx

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, sse, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "archy": {
      "args": [
        "mcp"
      ],
      "command": "archy"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-hslee16-archy)](https://mcppedia.org/s/io-github-hslee16-archy)

Read me

What io.github.hslee16/archy does

Architectural sensor for Python codebases - keeps structure honest under AI-assisted development.

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'archy' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

83/100across 5 weighted dimensions

How we score →

0255075100

−17

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked archy against OSV.dev.

Inventory

Tools (8)

Click any tool to inspect its schema.

~655 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.hslee16/archy safe to use?: io.github.hslee16/archy has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.hslee16/archy?: io.github.hslee16/archy supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.hslee16/archy do?: io.github.hslee16/archy provides 8 tools: graph, cycles, check, contracts, score and 3 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.hslee16/archy?: io.github.hslee16/archy is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.
Is io.github.hslee16/archy actively maintained?: io.github.hslee16/archy is actively maintained — last commit was 7 days ago. It has 1 GitHub stars.

Similar servers

Others in other

View all →

Pi Lean Ctx95

Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.

2.4k 6

Sigmap94

97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server

491 6

Sunpeak93

App framework, testing framework, and inspector for MCP Apps.

188 1

Caveman Shrink93

MCP proxy that compresses prose fields (tool descriptions, etc.) using caveman rules. Same accuracy, fewer context tokens.

68.2k 4

MCP Security Weekly

Get CVE alerts and security updates for io.github.hslee16/archy and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

pip install archy archy score . # one-shot architectural health number archy hotspots . # refactor priority = complexity x git churn archy mcp # expose 18 tools to Claude Code, Cursor, any MCP client

Mode	Command
Inspection	`archy graph`, `archy cycles`
CI governance	`archy check` (reads `archy.yaml`)
Transitive contracts	`archy contracts` (reads `.importlinter` (canonical) or falls back to `archy.yaml`; requires `archy[contracts]`)
One-shot score	`archy score`
Trended score	`archy score --record` + `archy trend`
Refactor priority	`archy hotspots` (CC x git churn)
CI impact lookup	`archy affected` (`git diff` -> impacted modules + tests, depth-capped)
MCP server	`archy mcp` (cached: warm graph builds in seconds even on 10k+ module repos)
Parse cache	`archy index sync` / `archy index clear` (persistent `.archy/index.db`; transparent under the MCP server)
Agent install	`archy install` / `archy uninstall` (auto-detect Claude Code, Cursor, Codex, opencode, Continue; wire in or cleanly remove the MCP server)

Mode

Command

Inspection

archy graph, archy cycles

CI governance

archy check (reads archy.yaml)

Transitive contracts

archy contracts (reads .importlinter (canonical) or falls back to archy.yaml; requires archy[contracts])

One-shot score

archy score

Trended score

archy score --record + archy trend

Refactor priority

archy hotspots (CC x git churn)

CI impact lookup

archy affected (git diff -> impacted modules + tests, depth-capped)

MCP server

archy mcp (cached: warm graph builds in seconds even on 10k+ module repos)

Parse cache

archy index sync / archy index clear (persistent .archy/index.db; transparent under the MCP server)

Agent install

archy install / archy uninstall (auto-detect Claude Code, Cursor, Codex, opencode, Continue; wire in or cleanly remove the MCP server)

Why

I built archy because I kept watching coding agents generate code that passed review but rotted the import graph underneath. The score on a feature change would look fine; six weeks later the cycle count had doubled and nobody noticed until a refactor blew up. I wanted a single number per commit that would have caught it.

AI agents generate code at machine speed. Without a feedback loop on structural health (module coupling, import cycles, layer violations), codebases drift architecturally even when every individual change looks fine in review.

archy watches a Python codebase, builds a live module-dependency graph, and surfaces drift through a single trended score plus a handful of actionable sub-metrics. It's designed to run in CI, in pre-commit, and as an MCP server (archy mcp) so coding agents can read their own architectural impact before committing.

The agent-feedback framing is empirically supported by 2025-2026 research: the Navigation Paradox paper shows large LLM context windows do not eliminate the need for structural graph navigation, LocAgent's ablation finds graph edges materially improve code-localization accuracy, the Constraint Decay paper (arxiv:2605.06445) finds agents lose ~30 points in pass rate as architectural constrain

Frequently Asked Questions

Is io.github.hslee16/archy safe to use?

io.github.hslee16/archy has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.hslee16/archy?

io.github.hslee16/archy supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.hslee16/archy do?

io.github.hslee16/archy provides 8 tools: graph, cycles, check, contracts, score and 3 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.hslee16/archy?

io.github.hslee16/archy is compatible with claude-desktop, cursor, claude-code. It uses stdio and sse and http transport.

Is io.github.hslee16/archy actively maintained?

io.github.hslee16/archy is actively maintained — last commit was 7 days ago. It has 1 GitHub stars.

Mode	Command
Inspection	`archy graph`, `archy cycles`
CI governance	`archy check` (reads `archy.yaml`)
Transitive contracts	`archy contracts` (reads `.importlinter` (canonical) or falls back to `archy.yaml`; requires `archy[contracts]`)
One-shot score	`archy score`
Trended score	`archy score --record` + `archy trend`
Refactor priority	`archy hotspots` (CC x git churn)
CI impact lookup	`archy affected` (`git diff` -> impacted modules + tests, depth-capped)
MCP server	`archy mcp` (cached: warm graph builds in seconds even on 10k+ module repos)
Parse cache	`archy index sync` / `archy index clear` (persistent `.archy/index.db`; transparent under the MCP server)
Agent install	`archy install` / `archy uninstall` (auto-detect Claude Code, Cursor, Codex, opencode, Continue; wire in or cleanly remove the MCP server)

Mode

Command

Inspection

archy graph, archy cycles

CI governance

archy check (reads archy.yaml)

Transitive contracts

archy contracts (reads .importlinter (canonical) or falls back to archy.yaml; requires archy[contracts])

One-shot score

archy score

Trended score

archy score --record + archy trend

Refactor priority

archy hotspots (CC x git churn)

CI impact lookup

archy affected (git diff -> impacted modules + tests, depth-capped)

MCP server

archy mcp (cached: warm graph builds in seconds even on 10k+ module repos)

Parse cache

archy index sync / archy index clear (persistent .archy/index.db; transparent under the MCP server)

Agent install

archy install / archy uninstall (auto-detect Claude Code, Cursor, Codex, opencode, Continue; wire in or cleanly remove the MCP server)

Why

io.github.hslee16/archy

Install in your client