Skip to main content
Glama
nest-openapi-mcp

nest-openapi-mcp

nest-openapi-mcp

Turn an existing NestJS API (already documented with @nestjs/swagger) into a spec-compliant Model Context Protocol server — with zero per-endpoint annotation, and execution that goes through the real Nest pipeline (Guards, Pipes, Interceptors, Scope.REQUEST providers), not a reimplementation of it.

Several NestJS↔MCP integrations already exist (notably rekog-labs/MCP-Nest), but they're decorator-based — you annotate each method you want exposed by hand. This project's angle is Swagger-driven auto-discovery: if your API already has @nestjs/swagger metadata (or even just class-validator decorators — see enrichEmptySchemas in @onkarsabale15/mcp-gen-core), tool schemas are derived from it directly, with a safe-by- default policy so nothing is LLM-callable until you explicitly opt it in.

Status: @onkarsabale15/mcp-gen-core (the OpenAPI → MCP schema engine) is built, tested, and validated against three independently-built NestJS codebases (see docs/real-world-validation-report.md). @onkarsabale15/mcp-gen-server (the actual NestJS module you'd install) and @onkarsabale15/mcp-gen-cli are still placeholders — this isn't installable as a working MCP server yet. See docs/mcp-generator-hld-lld.md for the full architecture and phased roadmap.

Packages

Package

Purpose

packages/common

Shared types, JSON-RPC types, error classes. No framework dependency.

packages/core

OpenAPI parsing, schema flattening, tool naming, tool registry, truncation. No NestJS dependency.

packages/server

NestJS dynamic module (McpModule.forRoot), decorators, discovery, in-process dispatch, transports.

packages/cli

Standalone CLI: turns any OpenAPI 3.0/3.1 document into a proxying MCP server.

Related MCP server: Swagger MCP Adapter

Usage

There are four distinct ways this is designed to be used — only one of them works today. See docs/usage/ for the full breakdown with a status table and a guide per mode:

Development

pnpm install
pnpm build
pnpm lint
pnpm typecheck
pnpm test

This repo uses pnpm workspaces + Turborepo, Changesets for versioning/publishing, and strict TypeScript throughout. See CONTRIBUTING.md for conventions, and SECURITY.md for the threat model and how to report a vulnerability privately.

Naming note

Packages are published under the author's personal npm scope (@onkarsabale15/mcp-gen-*) rather than a dedicated organization scope — no functional difference, just where the name is claimed from.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A NestJS module for building Model Context Protocol (MCP) servers using decorators to expose services as tools, resources, and prompts. It features auto-discovery, a built-in playground UI, and support for multiple transports including SSE and Stdio.
      5 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Transforms a NestJS REST API into an MCP server for AI agents to manage tasks securely via standardized tools.
      -