@nest-mcp/server

NestJS module for building Model Context Protocol (MCP) servers with decorators, auth, resilience, and multi-transport support.

Installation

npm install @nest-mcp/server @modelcontextprotocol/sdk zod@^4
npm install @nestjs/common @nestjs/core reflect-metadata rxjs

Quick start

// tools.service.ts
import { Injectable } from '@nestjs/common';
import { Tool } from '@nest-mcp/server';
import { z } from 'zod';

@Injectable()
export class ToolsService {
  @Tool({
    name: 'greet',
    description: 'Greet a user by name',
    schema: z.object({ name: z.string() }),
  })
  async greet({ name }: { name: string }) {
    return `Hello, ${name}!`;
  }
}

// app.module.ts
import { Module } from '@nestjs/common';
import { McpModule } from '@nest-mcp/server';
import { McpTransportType } from '@nest-mcp/server';

@Module({
  imports: [
    McpModule.forRoot({
      name: 'my-server',
      version: '1.0.0',
      transports: [{ type: McpTransportType.STREAMABLE_HTTP }],
    }),
  ],
  providers: [ToolsService],
})
export class AppModule {}

Decorators

| Decorator | Description | |-----------|-------------| | @Tool | Expose a method as an MCP tool | | @Resource | Expose a method as a static MCP resource | | @ResourceTemplate | Expose a method as a URI-template resource | | @Prompt | Expose a method as an MCP prompt | | @Completion | Provide argument completions for a prompt or resource |

Transports

• Streamable HTTP (McpTransportType.STREAMABLE_HTTP) — recommended, supports stateful and stateless modes
• SSE (McpTransportType.SSE) — Server-Sent Events (legacy)
• STDIO (McpTransportType.STDIO) — for CLI/subprocess use

Documentation

Full documentation: github.com/btwld/nest-mcp/docs/server

License

BSD-3-Clause