@jissp/nestjs-mcp-server 0.0.1

package/README.md

@@ -0,0 +1,163 @@
+# jissp-mcp-server-nestjs
+
+NestJS 기반의 Model Context Protocol (MCP) 서버 라이브러리입니다. 데코레이터와 메타데이터 스캐닝을 통해 MCP 리소스와 도구를 간편하게 정의하고 관리할 수 있습니다.
+
+## 설치
+
+```bash
+npm install jissp-mcp-server-nestjs
+```
+
+## 주요 기능
+
+- **데코레이터 기반 정의**: `@McpTool`, `@McpResource` 데코레이터로 리소스와 도구 정의
+- **자동 메타데이터 스캔**: 클래스와 메서드의 메타데이터 자동 수집
+- **Executor 패턴**: 커스텀 executor를 통한 확장 가능한 아키텍처
+- **JSON-RPC 통신**: 표준 JSON-RPC 2.0 프로토콜 지원
+- **세션 관리**: 세션 ID 기반 요청 추적 (Header: `mcp-session-id`)
+
+## 빠른 시작
+
+### 1. 전역 모듈 설정
+
+`AppModule`에서 `forRoot()`를 호출하여 MCP 서버의 핵심 인프라(Controller, Service 등)를 전역적으로 설정합니다.
+
+```typescript
+import { Module } from '@nestjs/common';
+import { McpServerModule } from 'jissp-mcp-server-nestjs';
+
+@Module({
+  imports: [
+    McpServerModule.forRoot(),
+  ],
+})
+export class AppModule {
+}
+```
+
+### 2. 도구(Tool) 및 리소스(Resource) 등록
+
+`forFeature()`를 사용하여 특정 도구나 리소스를 구현한 `executors`를 등록합니다.
+
+```typescript
+import { Module } from '@nestjs/common';
+import { McpServerModule } from 'jissp-mcp-server-nestjs';
+import { MyToolExecutor } from './my-tool.executor';
+import { MyResourceService } from './my-resource.service';
+
+@Module({
+  imports: [
+    McpServerModule.forFeature({
+      executors: [MyToolExecutor, MyResourceService],
+    }),
+  ],
+})
+export class MyFeatureModule {
+}
+```
+
+### 3. 도구(Tool) 정의
+
+도구는 `BaseExecutor` 인터페이스를 구현해야 하며, 실행 메서드에 `@McpTool` 데코레이터를 사용합니다.
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { McpTool, BaseExecutor, JsonRpcCallRequest } from 'jissp-mcp-server-nestjs';
+
+@Injectable()
+export class MyToolExecutor implements BaseExecutor {
+  @McpTool({
+    name: 'calculate-sum',
+    description: '두 숫자의 합을 계산합니다.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        a: { type: 'number' },
+        b: { type: 'number' },
+      },
+      required: ['a', 'b'],
+    },
+  })
+  async execute(request: JsonRpcCallRequest) {
+    const { a, b } = request.params.arguments as { a: number; b: number };
+    return a + b;
+  }
+}
+```
+
+### 4. 리소스(Resource) 정의
+
+리소스는 서비스 내의 메서드에 `@McpResource` 데코레이터를 사용하여 정의합니다. URI 템플릿을 지원합니다.
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { McpResource } from 'jissp-mcp-server-nestjs';
+
+@Injectable()
+export class MyResourceService {
+  @McpResource({
+    uri: 'file://{path}',
+    name: 'system-file',
+    description: '시스템 파일을 읽어옵니다.',
+    mimeType: 'text/plain',
+  })
+  async getFileContent(request: any) {
+    const { path } = request.params.arguments;
+    // 파일 읽기 로직...
+    return `Content of ${path}`;
+  }
+}
+```
+
+## API 레퍼런스
+
+### McpServerModule
+
+#### `forRoot()`
+
+MCP 서버의 핵심 기능(SSE 스트림, JSON-RPC 처리 등)을 전역 모듈로 등록합니다.
+
+#### `forFeature(options: McpServerFeatureOptions)`
+
+특정 도구(Tool)나 리소스(Resource)를 담당할 프로바이더를 등록합니다.
+
+- `executors`: `BaseExecutor`를 구현하거나 MCP 데코레이터가 사용된 프로바이더 배열.
+- `imports`: (선택) `executors`가 의존하는 다른 모듈들.
+
+### 데코레이터
+
+#### `@McpTool(options: McpToolOptions)`
+
+메서드를 MCP 도구로 등록합니다. 해당 클래스는 `BaseExecutor`를 구현해야 합니다.
+
+```typescript
+{
+  name: string;           // 도구 이름 (필수)
+  description ? : string;   // 도구 설명
+  inputSchema ? : any;      // JSON Schema 형식의 입력 파라미터 정의
+}
+```
+
+#### `@McpResource(options: McpResourceOptions)`
+
+메서드를 MCP 리소스로 등록합니다.
+
+```typescript
+{
+  uri: string;            // 리소스 URI 템플릿 (필수, 예: 'myschema://{id}')
+  name: string;           // 리소스 이름 (필수)
+  description ? : string;   // 리소스 설명
+  mimeType ? : string;      // 리소스의 MIME 타입
+}
+```
+
+## 아키텍처
+
+### 요청 흐름
+
+1. **클라이언트 SSE 연결** → `GET /mcp` (Header에 `mcp-session-id` 포함 권장)
+2. **JSON-RPC 요청** → `POST /mcp`
+3. **McpServerController** → 요청 수신 및 세션 검증 (`McpSessionIdGuard`)
+4. **McpServerService** → 메서드 핸들러 조회 및 `McpMetadataRegistryService` 참조
+5. **Executor / Handler** → `@McpTool` 클래스의 `execute` 또는 `@McpResource` 메서드 실행
+6. **응답** → JSON-RPC 결과 반환

package/dist/lib/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mcp-server';
+export * from './metadata-scanner';

package/dist/lib/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mcp-server"), exports);
+__exportStar(require("./metadata-scanner"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,qDAAmC"}

package/dist/lib/mcp-server/base.executor.d.ts

@@ -0,0 +1,4 @@
+import { JsonRpcCallRequest } from './mcp-server.types';
+export interface BaseExecutor<T = unknown> {
+    execute: (request: JsonRpcCallRequest) => T | Promise<T>;
+}

package/dist/lib/mcp-server/base.executor.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base.executor.js.map

package/dist/lib/mcp-server/base.executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.executor.js","sourceRoot":"","sources":["../../../lib/mcp-server/base.executor.ts"],"names":[],"mappings":""}

package/dist/lib/mcp-server/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mcp-tool.decorator';
+export * from './mcp-resource.decorator';

package/dist/lib/mcp-server/decorators/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mcp-tool.decorator"), exports);
+__exportStar(require("./mcp-resource.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/mcp-server/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/mcp-server/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,2DAAyC"}

package/dist/lib/mcp-server/decorators/mcp-resource.decorator.d.ts

@@ -0,0 +1,8 @@
+export declare const MCP_RESOURCE_METADATA = "MCP_RESOURCE_METADATA";
+export interface McpResourceOptions {
+    uri: string;
+    name: string;
+    mimeType?: string;
+    description?: string;
+}
+export declare const McpResource: (options: McpResourceOptions) => import("@nestjs/common").CustomDecorator<string>;

package/dist/lib/mcp-server/decorators/mcp-resource.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpResource = exports.MCP_RESOURCE_METADATA = void 0;
+const common_1 = require("@nestjs/common");
+exports.MCP_RESOURCE_METADATA = 'MCP_RESOURCE_METADATA';
+const McpResource = (options) => (0, common_1.SetMetadata)(exports.MCP_RESOURCE_METADATA, options);
+exports.McpResource = McpResource;
+//# sourceMappingURL=mcp-resource.decorator.js.map

package/dist/lib/mcp-server/decorators/mcp-resource.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resource.decorator.js","sourceRoot":"","sources":["../../../../lib/mcp-server/decorators/mcp-resource.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAEhC,QAAA,qBAAqB,GAAG,uBAAuB,CAAC;AAStD,MAAM,WAAW,GAAG,CAAC,OAA2B,EAAE,EAAE,CACzD,IAAA,oBAAW,EAAC,6BAAqB,EAAE,OAAO,CAAC,CAAC;AADjC,QAAA,WAAW,eACsB"}

package/dist/lib/mcp-server/decorators/mcp-tool.decorator.d.ts

@@ -0,0 +1,7 @@
+export declare const MCP_TOOL_METADATA = "MCP_TOOL_METADATA";
+export interface McpToolOptions {
+    name: string;
+    description?: string;
+    inputSchema?: any;
+}
+export declare const McpTool: (options: McpToolOptions) => import("@nestjs/common").CustomDecorator<string>;

package/dist/lib/mcp-server/decorators/mcp-tool.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpTool = exports.MCP_TOOL_METADATA = void 0;
+const common_1 = require("@nestjs/common");
+exports.MCP_TOOL_METADATA = 'MCP_TOOL_METADATA';
+const McpTool = (options) => (0, common_1.SetMetadata)(exports.MCP_TOOL_METADATA, options);
+exports.McpTool = McpTool;
+//# sourceMappingURL=mcp-tool.decorator.js.map

package/dist/lib/mcp-server/decorators/mcp-tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.decorator.js","sourceRoot":"","sources":["../../../../lib/mcp-server/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAEhC,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AAQ9C,MAAM,OAAO,GAAG,CAAC,OAAuB,EAAE,EAAE,CACjD,IAAA,oBAAW,EAAC,yBAAiB,EAAE,OAAO,CAAC,CAAC;AAD7B,QAAA,OAAO,WACsB"}

package/dist/lib/mcp-server/guards/index.d.ts

@@ -0,0 +1 @@
+export * from './mcp-session-id.guard';

package/dist/lib/mcp-server/guards/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./mcp-session-id.guard"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/mcp-server/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/mcp-server/guards/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}

package/dist/lib/mcp-server/guards/mcp-session-id.guard.d.ts

@@ -0,0 +1,4 @@
+import { CanActivate, ExecutionContext } from '@nestjs/common';
+export declare class McpSessionIdGuard implements CanActivate {
+    canActivate(context: ExecutionContext): boolean;
+}

package/dist/lib/mcp-server/guards/mcp-session-id.guard.js

@@ -0,0 +1,29 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpSessionIdGuard = void 0;
+const common_1 = require("@nestjs/common");
+let McpSessionIdGuard = class McpSessionIdGuard {
+    canActivate(context) {
+        const request = context.switchToHttp().getRequest();
+        const body = request.body;
+        if (body.method === 'initialize') {
+            return true;
+        }
+        const sessionId = request.headers['mcp-session-id'];
+        if (!sessionId) {
+            throw new common_1.BadRequestException('Missing MCP-Session-Id header');
+        }
+        return true;
+    }
+};
+exports.McpSessionIdGuard = McpSessionIdGuard;
+exports.McpSessionIdGuard = McpSessionIdGuard = __decorate([
+    (0, common_1.Injectable)()
+], McpSessionIdGuard);
+//# sourceMappingURL=mcp-session-id.guard.js.map

package/dist/lib/mcp-server/guards/mcp-session-id.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-session-id.guard.js","sourceRoot":"","sources":["../../../../lib/mcp-server/guards/mcp-session-id.guard.ts"],"names":[],"mappings":";;;;;;;;;AACA,2CAKwB;AAIjB,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAC5B,WAAW,CAAC,OAAyB;QACnC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;QAC7D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAsB,CAAC;QAG5C,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,4BAAmB,CAAC,+BAA+B,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AAjBY,8CAAiB;4BAAjB,iBAAiB;IAD7B,IAAA,mBAAU,GAAE;GACA,iBAAiB,CAiB7B"}

package/dist/lib/mcp-server/index.d.ts

@@ -0,0 +1,8 @@
+export * from './guards';
+export * from './decorators';
+export * from './mcp-server.types';
+export * from './base.executor';
+export * from './mcp-metadata-registry.service';
+export * from './mcp-server.controller';
+export * from './mcp-server.service';
+export * from './mcp-server.module';

package/dist/lib/mcp-server/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./guards"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./mcp-server.types"), exports);
+__exportStar(require("./base.executor"), exports);
+__exportStar(require("./mcp-metadata-registry.service"), exports);
+__exportStar(require("./mcp-server.controller"), exports);
+__exportStar(require("./mcp-server.service"), exports);
+__exportStar(require("./mcp-server.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/mcp-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/mcp-server/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,+CAA6B;AAC7B,qDAAmC;AACnC,kDAAgC;AAChC,kEAAgD;AAChD,0DAAwC;AACxC,uDAAqC;AACrC,sDAAoC"}

package/dist/lib/mcp-server/mcp-metadata-registry.service.d.ts

@@ -0,0 +1,21 @@
+import { OnModuleInit } from '@nestjs/common';
+import { MetadataScannerService } from '../metadata-scanner';
+import { McpResourceOptions, McpToolOptions } from './decorators';
+import { BaseExecutor } from './base.executor';
+export declare class McpMetadataRegistryService implements OnModuleInit {
+    private readonly metadataScanner;
+    private tools;
+    private resources;
+    constructor(metadataScanner: MetadataScannerService);
+    onModuleInit(): void;
+    private scanTools;
+    private scanResources;
+    getTools(): McpToolOptions[];
+    getToolExecutor(name: string): BaseExecutor<unknown> | undefined;
+    getResources(): McpResourceOptions[];
+    getResourceHandler(uri: string): {
+        handler: Function;
+        params: Record<string, string>;
+    } | null;
+    private matchUri;
+}

package/dist/lib/mcp-server/mcp-metadata-registry.service.js

@@ -0,0 +1,93 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpMetadataRegistryService = void 0;
+const common_1 = require("@nestjs/common");
+const metadata_scanner_1 = require("../metadata-scanner");
+const decorators_1 = require("./decorators");
+let McpMetadataRegistryService = class McpMetadataRegistryService {
+    metadataScanner;
+    tools = new Map();
+    resources = new Map();
+    constructor(metadataScanner) {
+        this.metadataScanner = metadataScanner;
+    }
+    onModuleInit() {
+        this.scanTools();
+        this.scanResources();
+    }
+    scanTools() {
+        const metadataList = this.metadataScanner.scan({
+            metadataKey: decorators_1.MCP_TOOL_METADATA,
+        });
+        metadataList.forEach(({ metadata, instance }) => {
+            const toolMeta = metadata;
+            this.tools.set(toolMeta.name, {
+                executor: instance,
+                metadata,
+            });
+        });
+    }
+    scanResources() {
+        const metadataList = this.metadataScanner.scan({
+            metadataKey: decorators_1.MCP_RESOURCE_METADATA,
+        });
+        metadataList.forEach(({ metadata, instance, methodName }) => {
+            this.resources.set(metadata.uri, {
+                handler: instance[methodName].bind(instance),
+                metadata,
+            });
+        });
+    }
+    getTools() {
+        return Array.from(this.tools.values()).map((t) => t.metadata);
+    }
+    getToolExecutor(name) {
+        return this.tools.get(name)?.executor;
+    }
+    getResources() {
+        return Array.from(this.resources.values()).map((r) => r.metadata);
+    }
+    getResourceHandler(uri) {
+        for (const [template, resource] of this.resources.entries()) {
+            const match = this.matchUri(template, uri);
+            if (match) {
+                return {
+                    handler: resource.handler,
+                    params: match,
+                };
+            }
+        }
+        return null;
+    }
+    matchUri(template, uri) {
+        const paramNames = [];
+        const regexSource = template.replace(/{([^}]+)}/g, (_, paramName) => {
+            paramNames.push(paramName);
+            return '([^/]+)';
+        });
+        const regex = new RegExp(`^${regexSource}$`);
+        const match = uri.match(regex);
+        if (!match)
+            return null;
+        const params = {};
+        paramNames.forEach((name, index) => {
+            params[name] = decodeURIComponent(match[index + 1]);
+        });
+        return params;
+    }
+};
+exports.McpMetadataRegistryService = McpMetadataRegistryService;
+exports.McpMetadataRegistryService = McpMetadataRegistryService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [metadata_scanner_1.MetadataScannerService])
+], McpMetadataRegistryService);
+//# sourceMappingURL=mcp-metadata-registry.service.js.map

package/dist/lib/mcp-server/mcp-metadata-registry.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-metadata-registry.service.js","sourceRoot":"","sources":["../../../lib/mcp-server/mcp-metadata-registry.service.ts"],"names":[],"mappings":"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"}

package/dist/lib/mcp-server/mcp-server.controller.d.ts

@@ -0,0 +1,12 @@
+import type { Request, Response } from 'express';
+import { Observable } from 'rxjs';
+import { MessageEvent } from '@nestjs/common';
+import type { JsonRpcRequest } from './mcp-server.types';
+import { McpServerService } from './mcp-server.service';
+export declare class McpServerController {
+    private readonly mcpService;
+    private eventSubject;
+    constructor(mcpService: McpServerService);
+    sse(req: Request): Observable<MessageEvent>;
+    handleIncomingMessage(body: JsonRpcRequest, res: Response): Promise<Response<any, Record<string, any>>>;
+}

package/dist/lib/mcp-server/mcp-server.controller.js

@@ -0,0 +1,64 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServerController = void 0;
+const rxjs_1 = require("rxjs");
+const common_1 = require("@nestjs/common");
+const mcp_server_service_1 = require("./mcp-server.service");
+const guards_1 = require("./guards");
+let McpServerController = class McpServerController {
+    mcpService;
+    eventSubject = new rxjs_1.Subject();
+    constructor(mcpService) {
+        this.mcpService = mcpService;
+    }
+    sse(req) {
+        const sessionId = req.headers['mcp-session-id'];
+        console.log(`SSE Connected with Session ID: ${sessionId?.toString() ?? 'unknown'}`);
+        return this.eventSubject.asObservable();
+    }
+    async handleIncomingMessage(body, res) {
+        const response = await this.mcpService.handleMessage(body);
+        if (!response) {
+            return res.status(common_1.HttpStatus.ACCEPTED).send();
+        }
+        if (body.method === 'initialize') {
+            res.setHeader('MCP-Session-Id', crypto.randomUUID());
+        }
+        return res.status(common_1.HttpStatus.OK).json(response.result);
+    }
+};
+exports.McpServerController = McpServerController;
+__decorate([
+    (0, common_1.Sse)(),
+    (0, common_1.Get)(),
+    __param(0, (0, common_1.Req)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", rxjs_1.Observable)
+], McpServerController.prototype, "sse", null);
+__decorate([
+    (0, common_1.UseGuards)(guards_1.McpSessionIdGuard),
+    (0, common_1.Post)(),
+    __param(0, (0, common_1.Body)()),
+    __param(1, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], McpServerController.prototype, "handleIncomingMessage", null);
+exports.McpServerController = McpServerController = __decorate([
+    (0, common_1.Controller)('mcp'),
+    __metadata("design:paramtypes", [mcp_server_service_1.McpServerService])
+], McpServerController);
+//# sourceMappingURL=mcp-server.controller.js.map

package/dist/lib/mcp-server/mcp-server.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.controller.js","sourceRoot":"","sources":["../../../lib/mcp-server/mcp-server.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AACA,+BAA2C;AAC3C,2CAWwB;AAExB,6DAAwD;AACxD,qCAA6C;AAGtC,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAGD;IAFrB,YAAY,GAAG,IAAI,cAAO,EAAgB,CAAC;IAEnD,YAA6B,UAA4B;QAA5B,eAAU,GAAV,UAAU,CAAkB;IAAG,CAAC;IAO7D,GAAG,CAAQ,GAAY;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CACT,kCAAkC,SAAS,EAAE,QAAQ,EAAE,IAAI,SAAS,EAAE,CACvE,CAAC;QAEF,OAAO,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC;IAC1C,CAAC;IAOK,AAAN,KAAK,CAAC,qBAAqB,CACjB,IAAoB,EACrB,GAAa;QAEpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,GAAG,CAAC,MAAM,CAAC,mBAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAChD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACjC,GAAG,CAAC,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,GAAG,CAAC,MAAM,CAAC,mBAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzD,CAAC;CAQF,CAAA;AA9CY,kDAAmB;AAU9B;IAFC,IAAA,YAAG,GAAE;IACL,IAAA,YAAG,GAAE;IACD,WAAA,IAAA,YAAG,GAAE,CAAA;;;oCAAgB,iBAAU;8CAOnC;AAOK;IAFL,IAAA,kBAAS,EAAC,0BAAiB,CAAC;IAC5B,IAAA,aAAI,GAAE;IAEJ,WAAA,IAAA,aAAI,GAAE,CAAA;IACN,WAAA,IAAA,YAAG,GAAE,CAAA;;;;gEAYP;8BAtCU,mBAAmB;IAD/B,IAAA,mBAAU,EAAC,KAAK,CAAC;qCAIyB,qCAAgB;GAH9C,mBAAmB,CA8C/B"}

package/dist/lib/mcp-server/mcp-server.module.d.ts

@@ -0,0 +1,6 @@
+import { DynamicModule } from '@nestjs/common';
+import { McpServerFeatureOptions } from './mcp-server.types';
+export declare class McpServerModule {
+    static forRoot(): DynamicModule;
+    static forFeature(options: McpServerFeatureOptions): DynamicModule;
+}

package/dist/lib/mcp-server/mcp-server.module.js

@@ -0,0 +1,40 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var McpServerModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServerModule = void 0;
+const common_1 = require("@nestjs/common");
+const metadata_scanner_1 = require("../metadata-scanner");
+const mcp_server_controller_1 = require("./mcp-server.controller");
+const mcp_metadata_registry_service_1 = require("./mcp-metadata-registry.service");
+const mcp_server_service_1 = require("./mcp-server.service");
+let McpServerModule = McpServerModule_1 = class McpServerModule {
+    static forRoot() {
+        return {
+            global: true,
+            module: McpServerModule_1,
+            imports: [metadata_scanner_1.MetadataScannerModule],
+            controllers: [mcp_server_controller_1.McpServerController],
+            providers: [mcp_metadata_registry_service_1.McpMetadataRegistryService, mcp_server_service_1.McpServerService],
+            exports: [],
+        };
+    }
+    static forFeature(options) {
+        return {
+            module: McpServerModule_1,
+            imports: [...(options.imports || [])],
+            providers: [...options.executors],
+            exports: [...options.executors],
+        };
+    }
+};
+exports.McpServerModule = McpServerModule;
+exports.McpServerModule = McpServerModule = McpServerModule_1 = __decorate([
+    (0, common_1.Module)({})
+], McpServerModule);
+//# sourceMappingURL=mcp-server.module.js.map

package/dist/lib/mcp-server/mcp-server.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.module.js","sourceRoot":"","sources":["../../../lib/mcp-server/mcp-server.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,0DAA4D;AAE5D,mEAA8D;AAC9D,mFAA6E;AAC7E,6DAAwD;AAGjD,IAAM,eAAe,uBAArB,MAAM,eAAe;IACnB,MAAM,CAAC,OAAO;QACnB,OAAO;YACL,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,iBAAe;YACvB,OAAO,EAAE,CAAC,wCAAqB,CAAC;YAChC,WAAW,EAAE,CAAC,2CAAmB,CAAC;YAClC,SAAS,EAAE,CAAC,0DAA0B,EAAE,qCAAgB,CAAC;YACzD,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,UAAU,CAAC,OAAgC;QACvD,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,OAAO,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACrC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;YACjC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;SAChC,CAAC;IACJ,CAAC;CACF,CAAA;AApBY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,eAAe,CAoB3B"}

package/dist/lib/mcp-server/mcp-server.service.d.ts

@@ -0,0 +1,18 @@
+import { JsonRpcErrorResult, JsonRpcRequest, JsonRpcResult } from './mcp-server.types';
+import { McpMetadataRegistryService } from './mcp-metadata-registry.service';
+type HandlerResult<T = unknown> = {
+    result: JsonRpcResult<T> | JsonRpcErrorResult;
+} | null;
+export declare class McpServerService {
+    private readonly registry;
+    private readonly methodHandlers;
+    constructor(registry: McpMetadataRegistryService);
+    handleMessage(message: JsonRpcRequest): Promise<HandlerResult>;
+    private initialize;
+    private toolsList;
+    private toolCall;
+    private resourceList;
+    private resourceRead;
+    private wrapResult;
+}
+export {};

package/dist/lib/mcp-server/mcp-server.service.js

@@ -0,0 +1,133 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServerService = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_metadata_registry_service_1 = require("./mcp-metadata-registry.service");
+let McpServerService = class McpServerService {
+    registry;
+    methodHandlers = new Map([
+        ['initialize', this.initialize.bind(this)],
+        ['tools/list', this.toolsList.bind(this)],
+        ['tools/call', this.toolCall.bind(this)],
+        ['resources/list', this.resourceList.bind(this)],
+        ['resources/read', this.resourceRead.bind(this)],
+    ]);
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async handleMessage(message) {
+        const { method, id } = message;
+        try {
+            const methodHandler = this.methodHandlers.get(method);
+            if (!methodHandler) {
+                return null;
+            }
+            return methodHandler(message);
+        }
+        catch (error) {
+            return {
+                result: {
+                    jsonrpc: '2.0',
+                    id,
+                    error: {
+                        code: -32603,
+                        message: error.message,
+                    },
+                },
+            };
+        }
+    }
+    initialize({ id }) {
+        return this.wrapResult(id, {
+            protocolVersion: '2024-11-05',
+            capabilities: {
+                tools: { listChanged: true },
+                resources: { subscribe: true, listChanged: true },
+            },
+            serverInfo: {
+                name: 'nestjs-mcp-server',
+                version: '1.0.0',
+            },
+        });
+    }
+    toolsList({ id }) {
+        return this.wrapResult(id, {
+            tools: this.registry.getTools().map((t) => ({
+                name: t.name,
+                description: t.description,
+                inputSchema: t.inputSchema || { type: 'object' },
+            })),
+        });
+    }
+    async toolCall(message) {
+        const { id, params } = message;
+        const executor = this.registry.getToolExecutor(params.name);
+        if (!executor) {
+            throw new Error(`Tool not found: ${params.name}`);
+        }
+        const executionResult = await executor.execute(message);
+        return this.wrapResult(id, {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(executionResult),
+                },
+            ],
+            isError: false,
+        });
+    }
+    resourceList({ id }) {
+        return this.wrapResult(id, {
+            resources: this.registry.getResources(),
+        });
+    }
+    async resourceRead(message) {
+        const { id, params } = message;
+        const uri = params.uri;
+        const matchResult = this.registry.getResourceHandler(uri);
+        if (!matchResult) {
+            throw new Error(`Resource not found: ${uri}`);
+        }
+        const { handler, params: uriParams } = matchResult;
+        const transformedRequest = {
+            ...message,
+            params: {
+                arguments: uriParams,
+            },
+        };
+        const executionResult = await handler(transformedRequest);
+        return this.wrapResult(id, {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(executionResult),
+                },
+            ],
+        });
+    }
+    wrapResult(id, result) {
+        return {
+            result: {
+                jsonrpc: '2.0',
+                id,
+                result,
+            },
+        };
+    }
+};
+exports.McpServerService = McpServerService;
+exports.McpServerService = McpServerService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [mcp_metadata_registry_service_1.McpMetadataRegistryService])
+], McpServerService);
+//# sourceMappingURL=mcp-server.service.js.map

package/dist/lib/mcp-server/mcp-server.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.service.js","sourceRoot":"","sources":["../../../lib/mcp-server/mcp-server.service.ts"],"names":[],"mappings":"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"}

package/dist/lib/mcp-server/mcp-server.types.d.ts

@@ -0,0 +1,28 @@
+import { ModuleMetadata, Provider } from '@nestjs/common';
+import { BaseExecutor } from './base.executor';
+export interface McpServerFeatureOptions extends Pick<ModuleMetadata, 'imports'> {
+    executors: Provider<BaseExecutor>[];
+}
+export interface McpServerConfig {
+    name: string;
+    version: string;
+    description?: string;
+}
+export interface CommonJsonRpc {
+    jsonrpc: '2.0';
+    id?: number | string;
+}
+export interface JsonRpcRequest<T = any> extends CommonJsonRpc {
+    method: string;
+    params: T;
+}
+export type JsonRpcCallRequest<T = unknown> = JsonRpcRequest<{
+    name: string;
+    arguments: T;
+}>;
+export interface JsonRpcResult<T = unknown> extends CommonJsonRpc {
+    result: T;
+}
+export interface JsonRpcErrorResult<T = unknown> extends CommonJsonRpc {
+    error: T;
+}

package/dist/lib/mcp-server/mcp-server.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp-server.types.js.map

package/dist/lib/mcp-server/mcp-server.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.types.js","sourceRoot":"","sources":["../../../lib/mcp-server/mcp-server.types.ts"],"names":[],"mappings":""}

package/dist/lib/metadata-scanner/index.d.ts

@@ -0,0 +1,3 @@
+export * from './metadata-scanner.types';
+export * from './metadata-scanner.service';
+export * from './metadata-scanner.module';

package/dist/lib/metadata-scanner/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./metadata-scanner.types"), exports);
+__exportStar(require("./metadata-scanner.service"), exports);
+__exportStar(require("./metadata-scanner.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/lib/metadata-scanner/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/metadata-scanner/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,6DAA2C;AAC3C,4DAA0C"}

package/dist/lib/metadata-scanner/metadata-scanner.module.d.ts

@@ -0,0 +1,2 @@
+export declare class MetadataScannerModule {
+}

package/dist/lib/metadata-scanner/metadata-scanner.module.js

@@ -0,0 +1,23 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataScannerModule = void 0;
+const common_1 = require("@nestjs/common");
+const metadata_scanner_service_1 = require("./metadata-scanner.service");
+const core_1 = require("@nestjs/core");
+let MetadataScannerModule = class MetadataScannerModule {
+};
+exports.MetadataScannerModule = MetadataScannerModule;
+exports.MetadataScannerModule = MetadataScannerModule = __decorate([
+    (0, common_1.Module)({
+        imports: [core_1.DiscoveryModule],
+        providers: [metadata_scanner_service_1.MetadataScannerService],
+        exports: [metadata_scanner_service_1.MetadataScannerService],
+    })
+], MetadataScannerModule);
+//# sourceMappingURL=metadata-scanner.module.js.map

package/dist/lib/metadata-scanner/metadata-scanner.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-scanner.module.js","sourceRoot":"","sources":["../../../lib/metadata-scanner/metadata-scanner.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,yEAAoE;AACpE,uCAA+C;AAOxC,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;CAAG,CAAA;AAAxB,sDAAqB;gCAArB,qBAAqB;IALjC,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAe,CAAC;QAC1B,SAAS,EAAE,CAAC,iDAAsB,CAAC;QACnC,OAAO,EAAE,CAAC,iDAAsB,CAAC;KAClC,CAAC;GACW,qBAAqB,CAAG"}

package/dist/lib/metadata-scanner/metadata-scanner.service.d.ts

@@ -0,0 +1,9 @@
+import { DiscoveryService, Reflector } from '@nestjs/core';
+import { MetadataScannerConfig, ScannedMetadata } from './metadata-scanner.types';
+export declare class MetadataScannerService {
+    private readonly reflector;
+    private readonly discovery;
+    constructor(reflector: Reflector, discovery: DiscoveryService);
+    scan(config: MetadataScannerConfig): ScannedMetadata[];
+    private getMethodNames;
+}

package/dist/lib/metadata-scanner/metadata-scanner.service.js

@@ -0,0 +1,66 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataScannerService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+let MetadataScannerService = class MetadataScannerService {
+    reflector;
+    discovery;
+    constructor(reflector, discovery) {
+        this.reflector = reflector;
+        this.discovery = discovery;
+    }
+    scan(config) {
+        const results = [];
+        const controllers = this.discovery.getControllers();
+        const providers = this.discovery.getProviders();
+        const wrappers = [...controllers, ...providers];
+        wrappers.forEach(({ instance }) => {
+            if (!instance || typeof instance !== 'object') {
+                return;
+            }
+            const prototype = Object.getPrototypeOf(instance);
+            if (!prototype) {
+                return;
+            }
+            const methodNames = this.getMethodNames(prototype);
+            methodNames.forEach((methodName) => {
+                const metadata = this.reflector.get(config.metadataKey, instance[methodName]);
+                if (!metadata) {
+                    return;
+                }
+                const result = {
+                    instance,
+                    methodName,
+                    metadata,
+                };
+                results.push(result);
+            });
+        });
+        return results;
+    }
+    getMethodNames(prototype) {
+        return Object.getOwnPropertyNames(prototype).filter((methodName) => {
+            const descriptor = Object.getOwnPropertyDescriptor(prototype, methodName);
+            return (descriptor &&
+                typeof descriptor.value === 'function' &&
+                methodName !== 'constructor');
+        });
+    }
+};
+exports.MetadataScannerService = MetadataScannerService;
+exports.MetadataScannerService = MetadataScannerService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.Reflector,
+        core_1.DiscoveryService])
+], MetadataScannerService);
+//# sourceMappingURL=metadata-scanner.service.js.map

package/dist/lib/metadata-scanner/metadata-scanner.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-scanner.service.js","sourceRoot":"","sources":["../../../lib/metadata-scanner/metadata-scanner.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,uCAA2D;AAOpD,IAAM,sBAAsB,GAA5B,MAAM,sBAAsB;IAEd;IACA;IAFnB,YACmB,SAAoB,EACpB,SAA2B;QAD3B,cAAS,GAAT,SAAS,CAAW;QACpB,cAAS,GAAT,SAAS,CAAkB;IAC3C,CAAC;IAKJ,IAAI,CAAC,MAA6B;QAChC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAEhD,MAAM,QAAQ,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,SAAS,CAAC,CAAC;QAChD,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YAChC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC9C,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;YACnD,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;gBACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CACjC,MAAM,CAAC,WAAW,EAClB,QAAQ,CAAC,UAAU,CAAC,CACrB,CAAC;gBACF,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO;gBACT,CAAC;gBAED,MAAM,MAAM,GAAoB;oBAC9B,QAAQ;oBACR,UAAU;oBACV,QAAQ;iBACT,CAAC;gBAEF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAKO,cAAc,CAAC,SAAc;QACnC,OAAO,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE;YACjE,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAE1E,OAAO,CACL,UAAU;gBACV,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU;gBACtC,UAAU,KAAK,aAAa,CAC7B,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA9DY,wDAAsB;iCAAtB,sBAAsB;IADlC,IAAA,mBAAU,GAAE;qCAGmB,gBAAS;QACT,uBAAgB;GAHnC,sBAAsB,CA8DlC"}

package/dist/lib/metadata-scanner/metadata-scanner.types.d.ts

@@ -0,0 +1,8 @@
+export interface ScannedMetadata {
+    instance: any;
+    methodName: string;
+    metadata: any;
+}
+export interface MetadataScannerConfig {
+    metadataKey: string | symbol;
+}

package/dist/lib/metadata-scanner/metadata-scanner.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=metadata-scanner.types.js.map

package/dist/lib/metadata-scanner/metadata-scanner.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-scanner.types.js","sourceRoot":"","sources":["../../../lib/metadata-scanner/metadata-scanner.types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@jissp/nestjs-mcp-server",
+  "version": "0.0.1",
+  "description": "NestJS-based MCP Server with metadata scanning support",
+  "author": "jissp <jisspant@gmail.com>",
+  "private": false,
+  "license": "MIT",
+  "main": "./dist/lib/index.js",
+  "types": "./dist/lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib/index.d.ts",
+      "import": "./dist/lib/index.js",
+      "require": "./dist/lib/index.js"
+    },
+    "./mcp-server": {
+      "types": "./dist/lib/mcp-server/index.d.ts",
+      "import": "./dist/lib/mcp-server/index.js",
+      "require": "./dist/lib/mcp-server/index.js"
+    },
+    "./metadata-scanner": {
+      "types": "./dist/lib/metadata-scanner/index.d.ts",
+      "import": "./dist/lib/metadata-scanner/index.js",
+      "require": "./dist/lib/metadata-scanner/index.js"
+    }
+  },
+  "files": [
+    "dist/lib",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jissp/jissp-mcp-server.git"
+  },
+  "homepage": "https://github.com/jissp/jissp-mcp-server#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "nestjs",
+    "metadata"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json --outDir dist/lib --rootDir lib",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "start": "nest start",
+    "test": "jest"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^11.0.1",
+    "@nestjs/core": "^11.0.1",
+    "@nestjs/platform-express": "^11.0.1",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@nestjs/cli": "^11.0.0",
+    "@nestjs/schematics": "^11.0.0",
+    "@nestjs/testing": "^11.0.1",
+    "@types/express": "^5.0.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.7",
+    "@types/supertest": "^6.0.2",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-plugin-prettier": "^5.2.2",
+    "globals": "^16.0.0",
+    "jest": "^30.0.0",
+    "prettier": "^3.4.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-jest": "^29.2.5",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}