ritualdev-lab/mcp-builder-kit

🛠️ mcp-builder-kit

Production Toolkit & Scaffolding Engine for Model Context Protocol (MCP) Servers. Scaffold typed TypeScript & FastMCP Python servers, generate tools from OpenAPI, run headless inspectors, and deploy to Claude Desktop, Antigravity, and Cursor in seconds.

🌐 Website & Docs • 📚 Developer Wiki • 💬 Discussions • 💜 Sponsor • ⚡ Bounties

---

🚀 Features

• ⚡ 1-Command Scaffolding: Run npx @ritualdev-lab/mcp-builder-kit init to generate a complete, battle-tested MCP server.
• 🌐 Dual Language Support:
  • TypeScript: @modelcontextprotocol/sdk + Zod schemas + tsup bundler + Biome linter.
  • Python: mcp[cli] + FastMCP + Pydantic v2.
• 🔌 Dual Transports: Ready-to-go stdio (Desktop/Agents) and sse (Remote/Docker).
• 🧩 Built-in Primitives: Fully wired Tool listings, Tool callers, Resources, and Metadata endpoints.
• 🛡️ Antigravity Skill Native: Includes a first-class SKILL.md for autonomous agent execution.

---

⚡ Quick Start

1. Scaffold a TypeScript MCP Server

npx @ritualdev-lab/mcp-builder-kit init my-tools-server

2. Scaffold a Python FastMCP Server

npx @ritualdev-lab/mcp-builder-kit init my-tools-server --lang python

3. Add a New Typed Tool to Your MCP Server

npx @ritualdev-lab/mcp-builder-kit add-tool search_knowledge \
  --desc "Search vector store for relevant documentation" \
  --params "query:string,limit:number,filter:object"

4. Convert OpenAPI / Swagger Spec into MCP Tools

npx @ritualdev-lab/mcp-builder-kit from-openapi ./petstore.json --lang typescript

5. Automated Protocol Conformance Inspection (CI/CD)

npx @ritualdev-lab/mcp-builder-kit inspect "node dist/index.js"

6. Pre-Flight Security & Injection Audit

npx @ritualdev-lab/mcp-builder-kit audit ./src

7. 1-Click Packaging & Containerization

# Generate Dockerfile, Claude Desktop config, Cursor config, and mcp.json registry manifest
npx @ritualdev-lab/mcp-builder-kit package ./my-server --lang typescript --port 8080 --env "OPENAI_API_KEY,DB_HOST"

---

💻 CLI Commands & Options

Commands:
  init [name]              Scaffolds a new MCP server project (interactive wizard if omitted)
  add-tool           Generates typed MCP tool code and JSON schema snippet
  from-openapi       Converts an OpenAPI / Swagger spec into production MCP tools
  inspect         Connects headless inspector to verify MCP JSON-RPC protocol conformance (--ci)
  deploy                   Generates serverless Cloudflare Workers or Cloud Run container deployment
  ui                       Launches lightweight local Visual Inspector Web UI & live testing studio
  audit [dir]              Runs AgentShield Zero-Leak security audit on MCP server source code
  package [dir]            Generates Dockerfile, client configs (Claude/Cursor) & registry manifest
  packs [list|install]     Browse or install enterprise connector packs (Postgres, K8s, Stripe)
  badge       Generates cryptographically verified AgentShield badge & checkout URL
  spotlight   Generates DevShelf Featured Spotlight placement and Dodo checkout link
  turnkey [tier]           Initiates B2B turnkey custom MCP server development inquiry & deposit link
  grants [id]              Browse foundation ecosystem grants ($1k-$25k) and generate grant pitch
  bounties                 Browse funded open-source bounties with Polar.sh rewards

---

🧩 Programmatic SDK

import {
  McpProjectScaffolder,
  McpCodeGenerator,
  OpenApiToMcpConverter,
  McpServerInspector,
  AgentShieldMcpAuditor,
  McpServerPackager,
} from "@ritualdev-lab/mcp-builder-kit";

// 1. Scaffold a project
const result = McpProjectScaffolder.scaffold({
  projectName: "sqlite-explorer",
  targetDir: "./servers/sqlite-explorer",
  language: "typescript",
  transport: "stdio",
  description: "SQLite database explorer MCP server",
});

// 2. Generate tool code dynamically
const toolCode = McpCodeGenerator.generateTypeScriptTool({
  name: "execute_query",
  description: "Runs a read-only SQL query on the database",
  parameters: [{ name: "sql", type: "string", required: true, description: "SQL query statement" }],
});

// 3. Convert an OpenAPI spec
const mcpTools = OpenApiToMcpConverter.convert({
  spec: mySwaggerJson,
  language: "typescript",
});

// 4. Headless Conformance Inspector
const inspector = new McpServerInspector({
  command: "node",
  args: ["./dist/index.js"],
});
const report = await inspector.inspect();
console.log(`Discovered ${report.discoveredTools.length} tools, latency: ${report.latencyMs}ms`);

// 5. AgentShield Pre-Flight Security Audit
const audit = AgentShieldMcpAuditor.auditDirectory("./src");
console.log(`Security Score: ${audit.score}/100, isSecure: ${audit.isSecure}`);

// 6. 1-Click Packaging & Dockerization
const pkg = McpServerPackager.package({
  serverName: "sqlite-explorer",
  targetDir: "./servers/sqlite-explorer",
  language: "typescript",
  port: 8080,
});
console.log(`Generated artifacts: ${pkg.writtenFiles.join(", ")}`);

---

💎 Enterprise Connectors & Ecosystem Services

mcp-builder-kit is open-source under Apache-2.0, with enterprise extensions, verified security certifications, and custom development available for production teams:

• Enterprise Connector Starters ($49): Pre-built production connectors for Postgres, Kubernetes, Stripe, and AWS with connection pooling and PII redaction (npx @ritualdev-lab/mcp-builder-kit packs).
• Verified Server Certification & Spotlight ($79): Cryptographic AgentShield zero-leak audit badge verified against repository commits, bundled with DevShelf directory showcase (npx @ritualdev-lab/mcp-builder-kit badge ).
• DevShelf Directory Spotlight ($149/mo): Standalone high-visibility directory placement and developer showcase across AI builders (npx @ritualdev-lab/mcp-builder-kit spotlight ).
• Turnkey B2B Engineering (From $1,750): Bespoke production MCP server engineering, private VPC networking, and SLA guarantees (npx @ritualdev-lab/mcp-builder-kit turnkey starter).
• Ecosystem Grants & Bounties: Connect to open-source foundation grant programs you can apply to ($1k–$25k) and funded developer bounties (npx @ritualdev-lab/mcp-builder-kit grants, npx @ritualdev-lab/mcp-builder-kit bounties).

👉 Explore full feature matrices and self-serve checkout at mcp.ritualdev.in

---

👥 Team & Contributors

MCP Builder Kit is initiated and maintained by the team at RitualDev Lab and expanded by the open-source MCP community.

🛡️ Core Team & Direct Access Admins

🌟 Community Contributors & Builders

Huge thanks to all our open-source Contributors! We warmly welcome issues, feedback, and pull requests.

Apache-2.0 License © 2026 RitualDev Lab