# Archaic MCP Server

MCP server that brings [Archaic](https://www.tryarchaic.com) 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](https://www.tryarchaic.com) 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](https://www.tryarchaic.com).

## Installation

```bash
npm install -g @archaic-ai/mcp
```

### Claude Code setup

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

```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](https://www.tryarchaic.com)
- [npm package](https://www.npmjs.com/package/@archaic-ai/mcp)

## License

MIT