NestJS REPL MCP Server

A Model Context Protocol (MCP) server that enables interaction with NestJS REPL from AI assistants.

Features

• Run commands in NestJS REPL interactively
• Persistent REPL sessions per project
• Clean output formatting

Requirements

• Node.js 16+
• NestJS project with REPL configured

Setup Your NestJS Project

1. Create repl.ts file in your project root

import { repl } from '@nestjs/core';
import { AppModule } from './src/app.module';

async function bootstrap() {
  await repl(AppModule);
}
bootstrap();

2. Add start:repl script to your package.json

{
  "scripts": {
    "start:repl": "nest start --entryFile repl"
  }
}

Installation

From GitHub (npx)

npx github:kostnerek/nestjs-repl-mcp

Local Development

npm install
npm run build
npm start

Usage with VS Code

Add to your mcp config file

{
  "servers": {
    "nestjs-repl": {
      "command": "npx",
      "args": [
        "-y",
        "github:kostnerek/nestjs-repl-mcp"
      ]
    }
  }
}

Or for local development:

{
  "servers": {
    "nestjs-repl": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp/build/client.js"
      ]
    }
  }
}

Available Tools

repl_command

Execute a command in a NestJS REPL.

Parameters:

• projectPath: Absolute path to the NestJS project
• command: Command to execute in the REPL

Example commands:

• get(AppService)
• await get(AppService).getHello()
• debug()
• methods

Requirements

• Node.js 16+
• NestJS projects with start:repl script configured

License

ISC