@mcpkit-dev/core

Core framework for building Model Context Protocol (MCP) servers with TypeScript decorators.

Installation

npm install @mcpkit-dev/core reflect-metadata zod

Quick Start

import 'reflect-metadata';
import { createServer, MCPServer, Tool, Param } from '@mcpkit-dev/core';

@MCPServer({
  name: 'my-server',
  version: '1.0.0',
})
class MyServer {
  @Tool({ description: 'Greet someone' })
  greet(@Param({ name: 'name', description: 'Name to greet' }) name: string) {
    return `Hello, ${name}!`;
  }
}

const server = createServer(MyServer);
await server.listen();

Features

• Decorators - @MCPServer, @Tool, @Resource, @Prompt, @Param
• Authentication - API key, JWT, Bearer token middleware
• Observability - @Debug, @Monitor, @Traced decorators
• Plugins - Extensible plugin system with lifecycle hooks
• Transports - stdio, HTTP/SSE, Streamable HTTP

Documentation

Read the full documentation

• Getting Started
• Tools Guide
• Resources Guide
• Authentication
• Plugins
• Observability
• API Reference

Using with Claude Desktop

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

TypeScript Configuration

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext"
  }
}

Related Packages

• @mcpkit-dev/cli - CLI for project scaffolding
• @mcpkit-dev/testing - Testing utilities

License

MIT