🤖 Enterprise Clean-Architecture API Agent (MCP-Powered)

An autonomous, deterministic API Development Agent integrated into VS Code via the Model Context Protocol (MCP). This agent automates the generation of production-grade, asynchronous FastAPI services adhering strictly to Clean Architecture principles, complete with automated test execution and self-healing verification loops.

🌟 Key Features

• Deterministic Code Generation: Employs Jinja2 templating rather than pure LLM generation to guarantee strict standard compliance.

• Clean Architecture Layers: Enforces separation across Model, Schema (DTO), Repository, Service, and Controller layers.

• Model Context Protocol (MCP): Exposes tool execution (file_ops, openapi_parser, pytest) to GitHub Copilot via lightweight JSON-RPC over STDIO.

• Self-Healing Verification Loop: Automatically executes pytest suite post-scaffolding and reads stack traces to auto-fix errors.

• OpenAPI Spec Ingestion: Parses existing OpenAPI (YAML/JSON) specifications to generate complete CRUD APIs automatically.

Related MCP server: FRD Orchestrator

🏗️ Architecture & Technology Stack

• Framework: FastAPI (Async)

• ORM: SQLAlchemy 2.0 (Async Session)

• Validation: Pydantic v2

• Agent Engine: FastMCP / Model Context Protocol

• Templating: Jinja2

• Testing: Pytest & httpx

Directory Structure

.
├── .vscode/
│   └── mcp.json                      # MCP Server configuration for VS Code
├── app/
│   ├── controllers/                  # FastAPI Routers
│   ├── models/                       # SQLAlchemy Database Models
│   ├── repositories/                 # Data Access Layer
│   ├── schemas/                      # Pydantic Schemas / DTOs
│   ├── services/                     # Business Logic Layer
│   └── main.py                       # Application Entrypoint & Router Discovery
├── mcp_server/
│   ├── server.py                     # FastMCP Tools Definition
│   └── tools/
│       ├── file_ops.py               # Template rendering & workspace disk writes
│       └── openapi_parser.py         # OpenAPI YAML/JSON schema parser
├── templates/                        # Jinja2 Standard Boilerplate Templates
├── tests/                            # Generated Pytest Test Suites
├── .agent.md                         # VS Code Copilot Custom Agent Prompt & Protocol
├── requirements.txt                  # Python dependencies
└── README.md