# 🏗️ Arch-Expert-MCP

**[English](README.md)** | **[简体中文](README.zh.md)**

![Example Usage](image.png)

**The Senior Consultant in your IDE.**

Arch-Expert-MCP is a professional-grade AI scaffolding agent built on the [Model Context Protocol](https://modelcontextprotocol.io). It bridges the gap between raw project concepts and production-ready repository structures, specifically designed for developers who value **Domain-Driven Design (DDD)** and **Clean Architecture**.

## 🎯 Core Intent

This tool automates the "Day Zero" friction of project setup, ensuring every new service or experiment starts with the same level of professional rigor a senior lead would provide during a design review.

- **Solve the "Naming Paradox"**: Replaces generic identifiers with context-aware, industry-standard names (e.g., `TransactionOrchestrator` instead of `MyLogic`).
- **Architectural Alignment**: Forces a choice between Enterprise (DDD/Hexagonal) and Personal (Standard) structures before any code is written.
- **Bilingual Scaffolding**: Automatically generates directory structures and documentation in both English and Chinese.
- **Automated Governance**: Audits existing projects for "leaky abstractions" where infrastructure details bleed into the domain.

## 🛠️ Features

- **Project Scaffolder**: Generates a compilable Java/Spring Boot 3.x project with Maven, H2, and Lombok.
- **Naming Engine**: A taxonomic mapping tool that resolves raw concepts into professional identifiers based on their architectural layer.
- **Structure Verifier**: Scans your project to ensure the Domain layer remains pure and free of infrastructure dependencies.
- **Git Automation**: Initializes repository with a professional `.gitignore` and follows **Conventional Commits** for the initial scaffold.

## 🚀 Getting Started

### Prerequisites

- Node.js v18+
- TypeScript
- An MCP-compatible client (e.g., Claude Desktop, Cursor)

### Installation

1. **Clone the repository**:

```bash
git clone https://github.com/your-repo/arch-expert-mcp.git
cd arch-expert-mcp

```

2. **Install dependencies**:

```bash
npm install

```

3. **Build the server**:

```bash
npm run build

```

### Configuration

Add the server to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "arch-expert": {
      "command": "node",
      "args": ["/path/to/arch-expert-mcp/build/server.js"]
    }
  }
}
```

## 🧠 Usage Examples

Once connected, you can give your AI commands like:

- _"I want to build a high-frequency trading bot in Java. Use the arch-expert tool to scaffold a DDD project in my projects folder."_
- _"I'm writing a component for payment processing in the infrastructure layer. Resolve the correct architectural name for me."_
- _"Verify my project structure to ensure I haven't leaked any JPA dependencies into the domain layer."_

---

## 🗺️ Roadmap

- [x] **Phase 1**: Foundation & SDK Setup
- [x] **Phase 2**: Java/Spring Boot DDD Blueprinting
- [x] **Phase 3**: Naming Paradox Resolution Engine
- [x] **Phase 4**: Architectural Verification & Git Automation
- [ ] **Phase 5**: Multi-language support (Go/Python Blueprints)