Feat: Added Mcp Integration

docker/docker-compose.yml

@@ -19,6 +19,21 @@ services:
     networks:
       - nestjs-todo-network
 
+  mcp-server:
+    build:
+      context: ..
+      dockerfile: ./docker/Dockerfile
+    command: ['npm', 'run', 'mcp:dev']
+    volumes:
+      - ../src:/usr/src/app/src
+    depends_on:
+      - mongo
+      - redis-db
+    env_file:
+      - ../.env
+    networks:
+      - nestjs-todo-network
+
   mongo:
     image: mongo
     container_name: todo-playground-mongo

package.json

@@ -6,6 +6,7 @@
   "private": true,
   "license": "UNLICENSED",
   "scripts": {
+    "mcp:dev": "ts-node -r tsconfig-paths/register src/mcp-server.ts",
     "build": "nest build",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "start": "nest start",
@@ -21,6 +22,7 @@
   },
   "dependencies": {
     "@elastic/elasticsearch": "9.0.3",
+    "@modelcontextprotocol/sdk": "1.18.1",
     "@nestjs-modules/ioredis": "2.0.2",
     "@nestjs/bullmq": "11.0.3",
     "@nestjs/common": "11.1.0",

src/app.module.ts

@@ -11,6 +11,7 @@ import { Environment } from './core/interface';
 import { TodoModule } from './modules/todo/todo.module';
 import { RabbitmqModule } from './modules/utils/rabbitmq/rabbitmq.module';
 import { LockModule } from './core/cache/lock/lock.module';
+import { McpModule } from './modules/mcp/mcp.module';
 
 @Module({
   imports: [
@@ -37,6 +38,7 @@ import { LockModule } from './core/cache/lock/lock.module';
     TodoModule,
     RabbitmqModule,
     LockModule,
+    McpModule,
   ],
 
   controllers: [],

src/core/error/error-code.ts

@@ -6,6 +6,9 @@ export enum ErrorCode {
   BAD_INPUT = 400100,
   NICKNAME_ALREADY_TAKEN = 400101,
   INVALID_CREDENTIALS = 400103,
+  //MCP
+  MCP_TOOL_NOT_FOUND = 400200,
+  MCP_CATEGORY_NOT_SUPPORTED = 400201,
 
   // 401
   UNAUTHORIZED = 40100,

src/core/error/exception/index.ts

@@ -10,3 +10,5 @@ export * from './unauthorized.exception';
 export * from './invalid-refresh-token.exception';
 export * from './todo-not-found.exception';
 export * from './todo-deletion-pending.exception';
+export * from './mcp-tool-not-found.exception';
+export * from './mcp-category-not-supported.exception';

src/core/error/exception/mcp-category-not-supported.exception.ts

@@ -0,0 +1,12 @@
+import { ErrorCode } from '../error-code';
+import { BadInputException } from './bad-input.exception';
+
+export class McpCategoryNotSupportedException extends BadInputException {
+  constructor(category: string) {
+    super(
+      `MCP tool category '${category}' is not supported`,
+      ErrorCode.MCP_CATEGORY_NOT_SUPPORTED,
+      `Category '${category}' is not available`,
+    );
+  }
+}

src/core/error/exception/mcp-tool-not-found.exception.ts

@@ -0,0 +1,12 @@
+import { ErrorCode } from '../error-code';
+import { NotFoundException } from './not-found.exception';
+
+export class McpToolNotFoundException extends NotFoundException {
+  constructor(toolName: string) {
+    super(
+      `MCP tool '${toolName}' not found`,
+      ErrorCode.MCP_TOOL_NOT_FOUND,
+      `Tool '${toolName}' is not available`,
+    );
+  }
+}

src/core/interface/index.ts

@@ -1,3 +1,4 @@
 export * from './environment.interface';
 export * from './mongo-model';
 export * from './bullmq';
+export * from './mcp';

src/core/interface/mcp/index.ts

@@ -0,0 +1 @@
+export * from './mcp-tool.const';

src/core/interface/mcp/mcp-tool.const.ts

@@ -0,0 +1,38 @@
+export const McpTool = {
+  AUTH_REGISTER: {
+    name: 'auth_register',
+    description: 'Register a new user',
+    category: 'auth' as const,
+  },
+  AUTH_LOGIN: {
+    name: 'auth_login',
+    description: 'Login user and get access token',
+    category: 'auth' as const,
+  },
+  TODO_CREATE: {
+    name: 'todo_create',
+    description: 'Create a new todo item',
+    category: 'todo' as const,
+  },
+  TODO_LIST: {
+    name: 'todo_list',
+    description: 'List user todos with pagination',
+    category: 'todo' as const,
+  },
+  TODO_UPDATE: {
+    name: 'todo_update',
+    description: 'Update an existing todo',
+    category: 'todo' as const,
+  },
+  TODO_DELETE: {
+    name: 'todo_delete',
+    description: 'Delete a todo item',
+    category: 'todo' as const,
+  },
+} as const;
+
+// Type utilities
+export type McpToolKey = keyof typeof McpTool;
+export type McpToolValue = (typeof McpTool)[McpToolKey];
+export type McpToolName = McpToolValue['name'];
+export type McpToolCategory = McpToolValue['category'];

src/mcp-server.ts

@@ -0,0 +1,13 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+import { McpServer } from './modules/mcp/server/mcp.server';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  const mcpServer = app.get(McpServer);
+
+  await mcpServer.start();
+}
+
+bootstrap();

src/modules/mcp/mcp.module.ts

@@ -0,0 +1,11 @@
+import { Module } from '@nestjs/common';
+import { McpServer } from './server/mcp.server';
+import { AuthModule } from '../auth/auth.module';
+import { UserModule } from '../user/user.module';
+
+@Module({
+  imports: [AuthModule, UserModule],
+  providers: [McpServer],
+  exports: [McpServer],
+})
+export class McpModule {}