mcp-kit

mcp-kit is a CLI tool that scaffolds MCP (Model Context Protocol) projects, focusing on creating MCP servers and clients with built-in development tooling and templates. When you run it, you can generate a full MCP server project that includes tools, resources, and prompts, along with transport implementations (stdio, streamable HTTP, and SSE) and a ready-to-edit TypeScript codebase. Use it to rapidly bootstrap an MCP server that exposes a set of tools, resources, and prompts for MCP clients, and leverage the provided build, test, and lint scripts to iterate on your server.

To use it, first scaffold a project with the command recommended by the tool, then open the generated src directory to implement your own MCP tools, resources, and prompts. You can run the development server in stdio mode or web/streamable modes as described in the project’s scripts. The server also includes example sections for integrating tools, resources, and prompts, so you can adapt the provided templates to your domain-specific needs. Don’t forget to configure the transport mode you’ll use in your client (stdio, HTTP streaming, or SSE) to connect to your server and exercise its MCP API.

Prerequisites:

• Node.js (LTS) and npm or a compatible package manager installed on your machine.
• Internet access to fetch the generator package from npm.

Installation steps:

1. Ensure you have npm available (node and npm are installed with Node.js).

2. Create a new MCP project using the mcp-kit generator:

   npm create mcp-kit@latest

   This will scaffold a new MCP server project (and optionally a client, depending on prompts).

3. When prompted (if any), choose the MCP Server template to generate a server project.

4. Change into the generated project directory and install dependencies:

   cd path-to-generated-project npm install

5. Start the development server (as documented in the generated package.json scripts), for example:

   npm run dev

6. Open the server entry point (typically under src/index.ts) to customize tools, resources, and prompts as needed.

Tips and notes:

• The MCP server scaffolding supports three transport modes: STDIO, Streamable HTTP, and SSE. Choose the mode that best fits your client integration.
• The generated project includes built-in scripts for development (dev, dev:web), building, testing (vitest-based if configured), linting, and coverage.
• If you plan to publish or reuse the server template, ensure your environment variables (env) are set appropriately for any external services or data sources your tools rely on.
• Common issues may include missing TypeScript typings or misconfigured transport endpoints. Refer to the generated README and the src/** folders for examples on registering tools, resources, and prompts.
• You can customize or replace the default MCP tool/resource/prompt registrations by editing the corresponding files in src/tools, src/resources, and src/prompts.
• The npm package name for the server generator is mcp-kit; use this in any automation scripts or MCP client/server integration docs.