NestJS MCP Server Module

A NestJS module to effortlessly expose tools, resources, and prompts for AI, from your NestJS applications using the Model Context Protocol (MCP).

With @rekog/mcp-nest you define tools, resources, and prompts in a way that's familiar in NestJS and leverage the full power of dependency injection to utilize your existing codebase in building complex enterprise ready MCP servers.

Features

🚀 Multi-Transport Support: HTTP+SSE, Streamable HTTP, and STDIO
🔧 Tools: Expose NestJS methods as MCP tools with automatic discovery and Zod validation
- 🛠️ Elicitation: Interactive tool calls with user input elicitation
- 📊 Progress Notifications: Real-time progress updates for long-running operations
- 🌐 HTTP Request Access: Full access to request context within MCP handlers
📁 Resources: Serve content and data through MCP resource system
📚 Resource Templates: Dynamic resources with parameterized URIs
💬 Prompts: Define reusable prompt templates for AI interactions
🔐 Guard-based Authentication: Guard-based security with OAuth support
🏠 Built-in Authorization Server — Using the built-in Authorization Server for easy setups. (Beta)
🌐 External Authorization Server — Securing your MCP server with an external authorization server (Keycloak, Auth0, etc).
💉 Dependency Injection: Leverage NestJS DI system throughout MCP components

Installation

npm install @rekog/mcp-nest @modelcontextprotocol/sdk zod@^3

Quick Start

// app.module.ts
import { Module } from '@nestjs/common';
import { McpModule } from '@rekog/mcp-nest';
import { GreetingTool } from './greeting.tool';

@Module({
  imports: [
    McpModule.forRoot({
      name: 'my-mcp-server',
      version: '1.0.0',
    }),
  ],
  providers: [GreetingTool],
})
export class AppModule {}

// greeting.tool.ts
import { Injectable } from '@nestjs/common';
import { Tool, Context } from '@rekog/mcp-nest';
import { z } from 'zod';

@Injectable()
export class GreetingTool {
  @Tool({
    name: 'greeting-tool',
    description: 'Returns a greeting with progress updates',
    parameters: z.object({
      name: z.string().default('World'),
    }),
  })
  async sayHello({ name }, context: Context) {
    await context.reportProgress({ progress: 50, total: 100 });
    return `Hello, ${name}!`;
  }
}

Documentation

Tools Guide - Define and expose NestJS methods as MCP tools
Resources Guide - Serve static and dynamic content
Resource Templates Guide - Create parameterized resources
Prompts Guide - Build reusable prompt templates
Built-in Authorization Server - Secure your MCP server with built-in OAuth
External Authorization Server - Securing your MCP server with an external authorization server (Keycloak, Auth0, etc)
Server examples - MCP servers examples (Streamable HTTP, HTTP, and STDIO) and with Fastify support

Playground

The playground directory contains working examples for all features. Refer to playground/README.md for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A NestJS module that allows services to be exposed as an MCP server with Server-Sent Events transport, facilitating tool discovery and execution by clients.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Hello World MCP Server
jageenshukla
-
security
A
license
-
quality
A demonstration server that implements the Model Context Protocol (MCP) SDK, providing tools and endpoints for server-sent events and message handling.
Last updated -
19
10
MIT License
SSE MCP Server
KelvinQiu802
-
security
F
license
-
quality
A server for Model Context Protocol (MCP) that uses Server-Sent Events (SSE) for streaming communication, enabling tools like the HackerNews API to be accessed through a secure HTTP+SSE transport.
Last updated -
23
Myrcael
michaelsong4399
-
security
A
license
-
quality
A TypeScript framework for building MCP servers with features for client sessions, authentication, image/audio content, and typed server events.
Last updated -
MIT License
Nexmo Messages MCP Server
ag2-mcp-servers
-
security
F
license
-
quality
An MCP server that enables interaction with Nexmo's Messages API, allowing agents to send and manage messages across various channels via natural language commands.
Last updated -

View all related MCP servers

NestJS MCP Server Module