🛠️ 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

• ⚡ 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.
• 🔌 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.

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

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

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

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

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

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

# 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"

Commands:
  init <name>              Scaffolds a new MCP server project
  add-tool <name>          Generates typed MCP tool code and JSON schema snippet
  from-openapi <path>      Converts an OpenAPI / Swagger spec into production MCP tools
  inspect <command>        Connects headless inspector to verify MCP JSON-RPC protocol conformance
  audit [dir]              Runs AgentShield Zero-Leak security audit on MCP server source code
  package [dir]            Generates Dockerfile, client configs (Claude/Cursor) & registry manifest

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(", ")}`);

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 <name>).
• DevShelf Directory Spotlight ($149/mo): Standalone high-visibility directory placement and developer showcase across AI builders (npx @ritualdev-lab/mcp-builder-kit spotlight <name>).
• 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

Initiated and maintained with 💜 by RitualDev Lab.

Apache-2.0 License © 2026 RitualDev Lab