🏗️ Arch-Expert-MCP

English | 简体中文

The Senior Consultant in your IDE.

Arch-Expert-MCP is a professional-grade AI scaffolding agent built on the Model Context Protocol. 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:

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

2. Install dependencies:

npm install

3. Build the server:

npm run build

Configuration

Add the server to your claude_desktop_config.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)