MCP DevKit Documentation¶
Self-hosted governance layer for MCP-based AI systems - connector registry, execution runtime, policy engine, audit trail, and eval framework.
Quick Links¶
| Section | What you'll find |
|---|---|
| Architecture | System design, module boundaries, data flow, infrastructure decisions. |
| Development | Setup guide, daily workflow, conventions, troubleshooting. |
| API | API design decisions, versioning, error format, authentication. |
| Build Phases | Detailed log of each development phase - what was built, why, and lessons learned. |
| ADRs | Architecture Decision Records for significant technical choices. |
Getting Started¶
git clone https://github.com/chitrank2050/mcp-devkit.git
cd mcp-devkit
pnpm install
cp .env.example .env
pnpm docker:up
cd apps/api
npx prisma migrate dev
npx prisma db seed
cd ../..
pnpm dev
App runs at http://localhost:3000. API docs at http://localhost:3000/api/docs.
Current Status¶
| Phase | Focus | Status |
|---|---|---|
| 1 | Foundation: monorepo, Docker Compose, single-user auth, Prisma, CI | ✅ Complete |
| 2 | Connector Registry: CRUD, discovery, sample servers | 🔜 Next |
| 3 | Execution Runtime: invocation proxy, retries, rate limits, smoke tests | - |
| 4 | Policy & Access Control: RBAC, allow/deny, approvals, secrets (MVP) | - |
| 5 | Audit & Observability: audit log, OpenTelemetry, Jaeger, Grafana | - |
| 6A | Testing Console: dashboard, playground, Ollama chat | - |
| 6B | Eval Framework: YAML suites, scoring, regression, CI gate | - |
| 7 | Hardening & Release: docs, demo, security, release workflow | - |
API Endpoints (Phase 1)¶
At the end of Phase 1, the foundation has been built with basic single-user authentication and health checks.
System¶
| Method | Path | Description |
|---|---|---|
| GET | /health |
System health check (Postgres, Redis) |
Auth (Coming Soon)¶
Authentication scaffolding is in place for a single-user system, to be expanded in later phases.