diagnose_repository
Analyze intake signals and return architecture, health, and intent before anything changes.
Example: “Run diagnose_repository on this repo — stabilize architecture before onboarding.”
01
A R K I T E C T M C P
Design the structure
before the code drifts.
Local MCP for Cursor and other AI builders. Diagnosis, pattern intelligence, and guidance grounded in your actual repo.
Open source
v2.1.0 — MCP stdio fix shipped
MCP-native for Cursor
SCROLL
OPEN SOURCE
Free and open source.
Arkitect stays open source — no membership, no paid spots. Install with the mcp.json path. If the tools help you, you can buy me a coffee.
Support is optional. Source is on GitHub.
MCP TOOLS
Click a card to unlock its tools. Click again to lock.
Diagnosis is the entry point — scan the repo, then decide. Nothing refactors until you ask.
get_last_diagnosis
Reuse the latest diagnosis payload without scanning again.
Example: “Show me the last diagnosis result.”
list_diagnosis_strategies
See how Arkitect continues healthy structure, reports drift, or defers a refactor.
Example: “What diagnosis strategies does Arkitect apply?”
suggest_requirement_tags
Suggest scope tags from the repo so diagnosis stays pointed at the right work.
Example: “Suggest requirement tags for this repo.”
Pattern intelligence — the catalog behind the algorithm. Same vocabulary as the architecture guide.
get_pattern_intelligence
Deep GoF data: intent, applicability, steps, pros/cons, and relations.
Example: “Get pattern intelligence for observer.”
recommend_patterns
Recommend patterns for this repo, with deferred options and an ADR summary.
Example: “Recommend patterns with complexityProfile balanced.”
list_design_principles
SOLID plus general OO principles Arkitect uses when scoring structure.
Example: “List the design principles Arkitect uses.”
list_design_patterns
The full catalog grouped by creational, structural, and behavioral families.
Example: “List design patterns available in the Arkitect catalog.”
Run verify and tests from the repo root — structured pass/fail the agent can act on.
verify_codebase
Full pipeline: lint, build, typecheck, test.
Example: “Verify the codebase at this path.”
run_tests
Unit and integration tests only — lighter than a full verify.
Example: “Run tests in this repo.”
run_test_suite
Scope a suite: unit, integration, or all.
Example: “Run the integration test suite.”
Report-only. Arkitect ranks techniques — it does not rewrite until you explicitly ask.
analyze_refactoring_opportunities
Rank Refactoring Guru techniques against structural smells. Reports only.
Example: “Analyze refactoring opportunities with explicit refactor intent.”
list_refactoring_techniques
The technique catalog grouped by category, with reference URLs.
Example: “List refactoring techniques for simplifying-conditionals.”
WHY ARKITECT
BEHIND THE ALGORITHM
The catalog Arkitect reasons with.
Diagnosis maps your repo onto design patterns, architecture styles, and SOLID — then reports before it refactors. Open the full guide on its own page.
OPEN THE GUIDEA R K I T E C T M C P
Architecture-first, design patterns second.
Diagnose first
Arkitect scans your repo and surfaces the real architecture, health, and intent before anything changes.
Continue what's healthy
Detected structure keeps flowing automatically once confidence is high — no forced rewrites.
Report before refactor
Drifting or spaghetti structure is reported clearly. Refactors only happen with explicit intent.
CURSOR MCP CONFIG
{
"mcpServers": {
"arkitect-mcp": {
"command": "node",
"args": [
"C:\\path\\to\\Arkitect-mcp.com\\packages\\mcp-server\\dist\\stdio.js"
],
"env": {
"ARKITECT_DEFAULT_REPO_PATH": "C:\\Dev\\YourRepo",
"ARKITECT_HOST_REPO_PATH": "C:\\path\\to\\Arkitect-mcp.com",
"ARKITECT_ANALYZER": "mock"
}
}
}
}Paste this into Cursor or any MCP host. Replace the three paths. No Windows installer.
GET STARTED IN FIVE STEPS
01
Install Node.js 18+
Node LTS, then corepack enable pnpm
02
Clone and build Arkitect
Confirm packages/mcp-server/dist/stdio.js exists
git clone https://github.com/ezequielcasillas1/Arkitect-MCP.AI.git
cd Arkitect-MCP.AI
pnpm install
pnpm --filter @arkitect/mcp-server build
03
Paste the JSON
Cursor Settings → MCP, or project .cursor/mcp.json
04
Replace the three paths
stdio.js, your repo, and the Arkitect clone
05
Restart MCP and diagnose
Ask the agent to call diagnose_repository
OPEN SOURCE
Free forever. Optional coffee.
Arkitect is open source — no membership, no paid spots. Install with mcp.json. If it helps you, buy me a coffee.
Buy me a coffee
AI PROVIDERS
Provider-agnostic by default.
You always connect your own provider API keys in the desktop app — or use Cursor's built-in AI when Arkitect runs as MCP in chat. Provider choice does not change how Arkitect reasons about your repo.
Composer 2.5
RECOMMENDED
Fast, cost-efficient. Default recommendation for Arkitect reasoning tasks.
Anthropic
Claude models for deep architectural analysis and complex reasoning.
OpenAI
GPT models for pattern recognition and code generation tasks.
Gemini
Google's models for multi-modal analysis and large context windows.
Groq
Ultra-fast inference for real-time diagnosis and quick scans.
Custom Provider
Bring your own endpoint — Ollama, LM Studio, or any OpenAI-compatible API.
TESTIMONIALS
Developers are talking
"Arkitect caught architectural drift in our monorepo that three code reviews missed. The diagnosis-first approach saved us weeks of refactoring in the wrong direction."
MK
Marcus Kim
STAFF ENGINEER
"Finally, an MCP tool that actually understands software architecture instead of just pattern-matching code. The vertical slice detection alone is worth it."
AS
Ana Santos
TECH LEAD
"Set it up in Cursor in under five minutes. The pattern recommendations are spot-on — it's like having a senior architect reviewing every decision."
JD
James Doyle
INDIE DEVELOPER
PRICING
Simple, transparent access
CURRENT
OPEN SOURCE
$0
forever — no cap
- Full MCP server access
- All diagnosis tools
- Pattern intelligence
- BYO AI provider keys
SUPPORT
Coffee
optional donation
- Buy Me a Coffee
- No membership required
- No paid spots
- Same open-source access
CONTRIBUTE
GitHub
clone and build
- Source on GitHub
- Local MCP stdio
- Issues and PRs welcome
- Same tools as everyone
CONNECT
Get in touch
Follow along or reach out if you need help — bugs, feature requests, or feedback. Every message gets read.