server

@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