Skip to main content
Glama
api-dev-agent-mcp

api-dev-agent-mcp

by okarin25

πŸ€– 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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A demonstration server that automatically generates Model Context Protocol (MCP) servers from OpenAPI specifications, providing seamless integration with FastAPI and supporting various transmission methods like STDIO, HTTP, and SSE.
      -
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that exposes structured Functional Requirements Documents (FRDs) to enable AI assistants like GitHub Copilot to automatically generate complete NestJS boilerplate architectures. It orchestrates the multi-phase creation of production-ready APIs including core CRUD, database integration, JWT authentication, and unit testing.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Generates production-ready MCP servers with dual-mode (MCP + CLI) architecture, tests, and documentation. Includes progressive disclosure tools for AI agents and best practices guidance.
      7
      Apache 2.0