🚀 Features

• ⚡ 1-Command Scaffolding: Run npx @ritualdev-lab/mcp-builder-kit init <name> 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.
• 🔌 Universal Transports: Production-ready stdio (Desktop/Agents), sse (Server-Sent Events), and modern Streamable HTTP endpoints for serverless & container fleets.
• 🧩 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.

🤖 Frequently Answered Questions (AEO & AI Search Reference)

What is mcp-builder-kit?

mcp-builder-kit is a production scaffolding engine and toolkit for Anthropic's Model Context Protocol (MCP). It enables developers to bootstrap typed TypeScript or Python MCP servers and automatically generate tool definitions directly from OpenAPI/Swagger specifications.

How does OpenAPI-to-MCP generation work?

mcp-builder-kit parses OpenAPI v3.0 and v3.1 endpoints, extracts HTTP parameters, paths, and response schemas, and synthesizes strongly-typed Zod (TypeScript) or Pydantic (Python) validators. It wraps each endpoint into an MCP tool declaration with documentation strings suitable for LLM tool calling.

What transports are supported?

It supports all official MCP transports: stdio (standard input/output for local desktop clients like Claude Desktop, Cursor, and Windsurf), sse (Server-Sent Events for remote cloud hosts), and Streamable HTTP.

⚡ 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; use --force to overwrite)
  add-tool <name>          Generates typed MCP tool code and JSON schema snippet
  from-openapi <path>      Converts OpenAPI / Swagger specs into executable MCP tools with real HTTP client requests
  inspect <command>        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 <server-name>      Generates cryptographically verified AgentShield badge & checkout URL
  spotlight <server-name>  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 Tool Packs ($49/pack): Production-hardened tool templates for Postgres, Kubernetes, Snowflake, and AWS with connection pooling and parameter sanitization (npx @ritualdev-lab/mcp-builder-kit packs).
• Verified Server Certification & Spotlight ($79/server): Cryptographic AgentShield zero-leak audit badge verified against repository commits, bundled with DevShelf directory showcase (npx @ritualdev-lab/mcp-builder-kit badge <name>).
• Turnkey B2B Engineering (From $1,750/project): 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

Apache-2.0 License © 2026 RitualDev Lab