MCPKit

v1.0.0Developer Toolsstable

MCPKit is a TypeScript library that lets you build MCP servers using decorators. Instead of manually wiring up handlers and schemas, you just decorate your methods and let the library handle the rest.

aimcpmcp-toolsnodejstypescript
Share:
27
Stars
0
Downloads
0
Weekly
0/5

What is MCPKit?

MCPKit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcpkit is a typescript library that lets you build mcp servers using decorators. instead of manually wiring up handlers and schemas, you just decorate your methods and let the library handle the rest.

MCPKit is a TypeScript library that lets you build MCP servers using decorators. Instead of manually wiring up handlers and schemas, you just decorate your methods and let the library handle the rest.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCPKit is a TypeScript library that lets you build MCP serve

Use Cases

Build MCP servers with decorators
TypeScript library
Automatic schema handling
EuKennedy

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.0.0
UpdatedFeb 12, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcpkit

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCPKit

MCPKit is a TypeScript library that simplifies building MCP servers by providing a decorator-style API built on top of Zod for schema validation. Instead of manually wiring up transport handlers and JSON Schema definitions, you define tools with defineTool(), configure the server with defineServer(), and let MCPKit handle schema generation, input validation, and error wrapping automatically. It supports stdio and HTTP streaming transports, built-in logging, and comes with a CLI for scaffolding, hot-reload development, and inspection.

Prerequisites

  • Node.js 18+ installed
  • npm or npx available
  • TypeScript knowledge (the library is TypeScript-first)
  • Zod installed as a peer dependency
  • An MCP-compatible client (Claude Desktop, Claude Code) to test your server
1

Scaffold a new MCP server project

Use the mcpkit CLI to generate a new project with the correct structure and dependencies pre-configured.

npx mcpkit create my-server
cd my-server
2

Install dependencies

Install MCPKit and Zod into an existing project, or if using the scaffold the dependencies are already included.

npm install mcpkit zod
3

Define a tool

Use defineTool() with a Zod input schema. MCPKit automatically converts the Zod schema to JSON Schema and validates inputs at runtime.

import { defineTool, defineServer } from 'mcpkit';
import { z } from 'zod';

const greetTool = defineTool({
  name: 'greet',
  description: 'Greet a user by name',
  input: z.object({ name: z.string() }),
  handler: ({ name }) => `Hello, ${name}!`
});
4

Create and start the server

Use defineServer() to configure the MCP server with your tools, then call .start() to listen on stdio.

const server = defineServer({
  name: 'my-server',
  version: '1.0.0',
  tools: [greetTool]
});

server.start();
5

Run with hot reload during development

Use the mcpkit dev command to run your server with automatic restart on file changes.

npx mcpkit dev
6

Build and register with Claude Desktop

Compile your server and add it to your Claude Desktop MCP config pointing to the compiled output.

npx mcpkit build

MCPKit Examples

Client configuration

Example Claude Desktop config for a compiled MCPKit server. Replace the path with your actual project's dist/index.js.

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/absolute/path/to/my-server/dist/index.js"]
    }
  }
}

Prompts to try

Once your MCPKit server is running, test it with prompts that invoke your defined tools.

- "Use the greet tool to say hello to Alice"
- "Inspect my server with 'npx mcpkit inspect' to list all registered tools"
- "Run 'npx mcpkit dev' and make changes to a tool handler to see hot reload in action"
- "Add onEvent logging to the server using consoleLogger() from mcpkit"
- "Create a new tool that fetches weather data using a Zod schema for city and units inputs"

Troubleshooting MCPKit

TypeScript compilation errors when defining tools

Ensure both mcpkit and zod are installed ('npm install mcpkit zod'). MCPKit requires Zod as a peer dependency. Check that your tsconfig.json has 'strict: true' and 'moduleResolution: bundler' or 'node16'.

Server starts but Claude Desktop shows no tools

Verify the path in args points to the compiled dist/index.js, not the TypeScript source. Run 'npx mcpkit build' first and confirm the dist/ directory is created. Also check that server.start() is called at the end of your entry file.

Hot reload with mcpkit dev does not pick up changes

Ensure you are editing files within the src/ directory. The dev command watches the source directory. If you restructured the project, check that the watch glob in your mcpkit configuration covers your source paths.

Frequently Asked Questions about MCPKit

What is MCPKit?

MCPKit is a Model Context Protocol (MCP) server that mcpkit is a typescript library that lets you build mcp servers using decorators. instead of manually wiring up handlers and schemas, you just decorate your methods and let the library handle the rest. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCPKit?

Follow the installation instructions on the MCPKit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCPKit?

MCPKit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCPKit free to use?

Yes, MCPKit is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcpkit": { "command": "npx", "args": ["-y", "mcpkit"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCPKit?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides