Prepare the server locally
Run this once before adding it to Claude Code.
uv syncAdd it to Claude Code
Paste the maintainer's config below, then edit any placeholder values.
{
"servers": {
"frd-orchestrator": {
"type": "stdio",
"command": "/Users/[your-username]/.local/bin/uv",
"args": [
"run",
"main.py"
]
}
}
}See the boilerplate-nestjs-mcp README for full setup instructions.
Make your agent remember this setup
frd-orchestrator's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Automated multi-phase NestJS boilerplate generation
- Structured FRD-based orchestration for consistent architecture
- Built-in validation and logging for generated code
- Support for Clean Architecture and SOLID principles
- Automatic generation of unit tests and documentation
Tools 1
read_frdAccesses structured FRD documents to guide the AI in generating NestJS architecture phases.Try it
Original README from jorge6242/boilerplate-nestjs-mcp
FRD Orchestrator - MCP Server
🚀 Automated NestJS boilerplate generation powered by MCP and structured FRDs
MCP (Model Context Protocol) server that exposes NestJS boilerplate FRDs so GitHub Copilot can regenerate the complete architecture from scratch in any project, following Clean Architecture, SOLID principles, and best practices.
🤔 What is MCP and why use it?
MCP (Model Context Protocol) is a standardized way for AI assistants like GitHub Copilot to access external tools and data sources. Think of it as a "bridge" that allows Copilot to:
- 📖 Read live documents (your FRDs) instead of outdated copies
- 🔧 Access specialized tools beyond basic file operations
- 📊 Get structured data with validation and logging
- 🔄 Always stay updated - changes to FRDs are immediately available
Why FRDs via MCP instead of just reading files?
| Traditional File Reading | MCP + FRDs |
|---|---|
| ❌ Stale content when files change | ✅ Always fresh content |
| ❌ No validation or error handling | ✅ Built-in validation and logging |
| ❌ Manual file path management | ✅ Structured ID-based access |
| ❌ No usage tracking | ✅ Full audit trail of what was read |
🎯 What does this server do?
This MCP server exposes 5 carefully crafted FRDs that define a complete NestJS boilerplate:
- FRD-00: 🎭 Master orchestration - How GitHub Copilot should execute the 4 phases
- FRD-01: 🏗️ Boilerplate core - Basic NestJS + Products CRUD + Swagger
- FRD-02: 🗄️ Database layer - TypeORM + migrations + repository pattern
- FRD-03: 🔐 Authentication - JWT + Passport + protected endpoints
- FRD-04: 🧪 Unit testing - Jest + mocks + coverage for all modules
🔄 How does the orchestration work?
When you tell GitHub Copilot to generate a boilerplate, here's what happens:
- 📋 Copilot reads FRD-00 (master orchestration) to understand the plan
- 🏗️ Phase 1: Reads FRD-01 → Creates basic NestJS + Products CRUD
- 🗄️ Phase 2: Reads FRD-02 → Adds database + TypeORM + migrations
- 🔐 Phase 3: Reads FRD-03 → Implements JWT auth + protected routes
- 🧪 Phase 4: Reads FRD-04 → Generates unit tests for everything
- 📝 Final: Generates comprehensive README with setup instructions
Each phase is automatic - no manual intervention required. GitHub Copilot follows the FRDs religiously and ensures each phase works before moving to the next.
✨ Complete workflow example
# 1. You say this to GitHub Copilot:
"folder name: my-api. Start the orchestration."
# 2. GitHub Copilot automatically:
# - Reads FRD-00 to understand the plan
# - Creates `my-api/` directory
# - Executes Phase 1: Basic NestJS setup
# - Executes Phase 2: Database integration
# - Executes Phase 3: JWT authentication
# - Executes Phase 4: Unit tests
# - Generates final README
# 3. Result: Complete production-ready API with:
# ✅ Products CRUD with validation
# ✅ Swagger documentation at /api
# ✅ Database persistence (SQLite by default)
# ✅ JWT authentication protecting all routes
# ✅ Unit tests with >80% coverage
# ✅ Clean Architecture + SOLID principles
# ✅ Complete setup documentation
The entire process takes 5-10 minutes and results in a production-ready NestJS API that you can deploy immediately.
Requirements
- Python 3.10+
- VS Code with GitHub Copilot enabled
- uv (recommended) or
pip
Installation
1. Clone/Copy this folder to your project
# Add this MCP server to your existing project
git clone <your-repo> mcp-server
cd mcp-server
2. Install dependencies
Option A: With uv (recommended)
uv sync
Option B: With pip
pip install fastmcp
3. Verify installation
python main.py
You should see logs like:
[FRD-Orchestrator] 12:34:56 | INFO | Starting MCP FRD-Orchestrator server (stdio)
[FRD-Orchestrator] 12:34:56 | INFO | FRD Directory: /path/to/mcp-server/frd
VS Code + GitHub Copilot Configuration
1. Create MCP configuration in your workspace
Create .vscode/mcp.json in your project root:
{
"_note": "This configuration is for academic purposes. The command path depends on the execution environment and may vary based on where the UV tool is installed on different systems.",
"servers": {
"frd-orchestrator": {
"type": "stdio",
"command": "/Users/[your-username]/.local/bin/uv",
"args": ["run", "main.py"]
}
}
}
⚠️ Important:
- Adjust the path to UV according to your system
- Use
which uvto find your UV installation path - If using Python directly:
"command": "python"and"args": ["main.py"]
2. Ensure GitHub Copilot has MCP access
GitHub Copilot in VS Code automatically detects MCP servers configured in .vscode/mcp.json when MCP s