Archaic MCP Server

MCP server that brings Archaic architecture analysis and visualization into Claude Code.

Archaic analyzes your codebase and generates interactive architecture diagrams — showing how components connect, how data flows, and how your system is structured. This MCP server lets Claude Code read and interact with that architecture data directly in your terminal.

What is Archaic?

Archaic is an AI-powered architecture analysis tool that understands your codebase and generates:

• Architecture diagrams — components, services, databases, and how they connect
• Execution flows — request traces showing how data moves through your system
• Code maps — function-level dependency graphs

Download the desktop app (macOS) at tryarchaic.com.

Installation

npm install -g @archaic-ai/mcp

Claude Code setup

Add to your Claude Code config (~/.claude.json):

{
  "mcpServers": {
    "archaic": {
      "command": "archaic-mcp"
    }
  }
}

Or for project-scoped config, add to .mcp.json in your project root.

You can also configure this directly from the Archaic desktop app under Settings > Claude Code Integration.

Tools

Tool	Description
get_desktop_architecture	Read the current architecture from the desktop app
update_architecture	Push architecture changes to the live diagram
create_task	Create a task for the desktop app
get_pending_task	Check for pending tasks from the UI
report_progress	Send status updates to the desktop app
complete_task	Mark a task as done

How It Works

The MCP server connects to the Archaic desktop app running locally. When Claude Code makes structural changes to your codebase, it can push updates to the architecture diagram in real-time.

The typical workflow:

1. Open your project in Archaic Desktop and run an analysis
2. Start Claude Code in your project — it connects to the MCP server automatically
3. As Claude modifies code, it reads the architecture, creates tasks, and pushes diagram updates
4. You see the architecture update live in the desktop app

Environment Variables

Variable	Required	Default	Description
ARCHAIC_DESKTOP_URL	No	http://127.0.0.1:7432	Desktop app endpoint

Example Usage

Once configured, you can ask Claude Code things like:

• "Show me the architecture of my project"
• "How does the authentication flow work?"
• "What components depend on the database service?"
• "Refactor the auth module and update the architecture"

Links

• Archaic Website
• npm package

License

MIT