@jissp/nestjs-mcp-server 0.0.6 → 0.0.8

package/README.md

@@ -1,10 +1,10 @@
 # nestjs-mcp-server
 
-> **참고**: 이 프로젝트는 토이프로젝트 또는 개인적인 용도로 로컬 MCP를 구현하기 위해 만든 Simple 모듈입니다.
-> 
-NestJS 기반의 Model Context Protocol (MCP) 서버 라이브러리입니다.
+> **참고**: 이 프로젝트는 NestJS 환경에서 Model Context Protocol (MCP) 서버를 간편하게 구축하기 위한 라이브러리입니다.
 
-데코레이터와 메타데이터 스캐닝을 통해 MCP 리소스와 도구를 간편하게 정의하고 관리할 수 있습니다.
+NestJS의 강력한 데코레이터와 메타데이터 스캐닝 기능을 활용하여 MCP 리소스(Resource)와 도구(Tool)를 정의하고 관리할 수 있습니다. 
+
+최신 버전은 공식 `@modelcontextprotocol/sdk`를 기반으로 하며, **SSE(Server-Sent Events)** 전송 방식을 지원합니다.
 
 ## 설치
 
@@ -14,17 +14,17 @@ npm install @jissp/nestjs-mcp-server
 
 ## 주요 기능
 
-- **데코레이터 기반 정의**: `@McpTool`, `@McpResource`, `@McpSchemaProperty` 데코레이터로 리소스와 도구 정의
-- **자동 메타데이터 스캔**: 클래스와 메서드의 메타데이터 자동 수집
-- **Executor 패턴**: 커스텀 executor를 통한 확장 가능한 아키텍처
-- **JSON-RPC 통신**: 표준 JSON-RPC 2.0 프로토콜 지원
-- **세션 관리**: 세션 ID 기반 요청 추적 (Header: `mcp-session-id`)
+- **공식 MCP SDK 기반**: `@modelcontextprotocol/sdk`를 사용하여 표준 규격 완벽 준수
+- **SSE 전송 방식**: 실시간 양방향 통신을 위한 SSE(Server-Sent Events) 지원
+- **데코레이터 기반 정의**: `@McpTool`, `@McpResource`, `@McpSchemaProperty`를 이용한 간결한 정의
+- **자동 메타데이터 스캔**: 클래스와 메서드에 정의된 MCP 메타데이터 자동 수집 및 등록
+- **Executor 패턴**: 비즈니스 로직을 분리하여 확장 가능한 구조 제공
 
 ## 빠른 시작
 
 ### 1. 전역 모듈 설정
 
-`AppModule`에서 `forRoot()`를 호출하여 MCP 서버의 핵심 인프라(Controller, Service 등)를 전역적으로 설정합니다.
+`AppModule`에서 `McpServerModule.forRoot()`를 호출하여 MCP 서버 인프라를 설정합니다.
 
 ```typescript
 import { Module } from '@nestjs/common';
@@ -35,20 +35,14 @@ import { McpServerModule } from '@jissp/nestjs-mcp-server';
     McpServerModule.forRoot(),
   ],
 })
-export class AppModule {
-}
+export class AppModule {}
 ```
 
 ### 2. 도구(Tool) 및 리소스(Resource) 등록
 
-`forFeature()`를 사용하여 특정 도구나 리소스를 구현한 `executors`를 등록합니다.
+`forFeature()`를 사용하여 MCP 요소들을 구현한 프로바이더를 등록합니다.
 
 ```typescript
-import { Module } from '@nestjs/common';
-import { McpServerModule } from '@jissp/nestjs-mcp-server';
-import { MyToolExecutor } from './my-tool.executor';
-import { MyResourceService } from './my-resource.service';
-
 @Module({
   imports: [
     McpServerModule.forFeature({
@@ -56,25 +50,44 @@ import { MyResourceService } from './my-resource.service';
     }),
   ],
 })
-export class MyFeatureModule {
+export class MyFeatureModule {}
+```
+
+### 3. 클라이언트 설정 (예: Claude Desktop)
+
+클라이언트(예: Claude Desktop)에서 이 서버를 사용하려면 다음과 같이 SSE 방식으로 설정해야 합니다.
+
+**`config.json` 예시:**
+
+```json
+{
+  "mcpServers": {
+    "my-nestjs-server": {
+      "command": "node",
+      "args": ["/path/to/your/server/dist/main.js"],
+      "env": {
+        "MCP_TRANSPORT": "sse",
+        "MCP_ENDPOINT": "http://localhost:3000/mcp/sse"
+      }
+    }
+  }
 }
 ```
 
-### 3. 도구(Tool) 정의
+*참고: 서버 주소는 기본적으로 `http://localhost:3000/mcp/sse`가 엔드포인트가 됩니다.*
 
-도구는 클래스 메서드에 `@McpTool` 데코레이터를 사용하여 정의합니다. 입력 스키마는 직접 JSON Schema 객체로 전달하거나, `@McpSchemaProperty`가 적용된 클래스를 전달하여 자동으로 생성할 수 있습니다.
+## 정의 가이드
 
-#### JSON Schema 직접 정의 방식
+### 도구(Tool) 정의
 
-```typescript
-import { Injectable } from '@nestjs/common';
-import { McpTool, JsonRpcCallRequest } from '@jissp/nestjs-mcp-server';
+`BaseExecutor` 인터페이스를 구현하고 `@McpTool` 데코레이터를 사용합니다.
 
+```typescript
 @Injectable()
-export class MyToolExecutor {
+export class CalculateSumExecutor implements BaseExecutor {
   @McpTool({
     name: 'calculate-sum',
-    description: '두 숫자의 합을 계산합니다.',
+    description: '두 숫자의 합을 구합니다.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -84,133 +97,37 @@ export class MyToolExecutor {
       required: ['a', 'b'],
     },
   })
-  async execute(request: JsonRpcCallRequest) {
-    const { a, b } = request.params.arguments as { a: number; b: number };
-    return a + b;
-  }
-}
-```
-
-#### @McpSchemaProperty 클래스 기반 방식
-
-```typescript
-import { Injectable } from '@nestjs/common';
-import { McpTool, McpSchemaProperty } from '@jissp/nestjs-mcp-server';
-
-export class CalculateSumDto {
-  @McpSchemaProperty({
-    type: 'number',
-    description: '첫 번째 숫자',
-    isRequired: true,
-  })
-  a: number;
-
-  @McpSchemaProperty({
-    type: 'number',
-    description: '두 번째 숫자',
-    isRequired: true,
-  })
-  b: number;
-}
-
-@Injectable()
-export class MyToolExecutor {
-  @McpTool({
-    name: 'calculate-sum',
-    description: '두 숫자의 합을 계산합니다.',
-    inputSchema: CalculateSumDto,
-  })
-  async execute(params: CalculateSumDto) {
-    return params.a + params.b;
+  async execute(request: JsonRpcToolRequest) {
+    const { a, b } = request.params.arguments;
+    return { result: a + b };
   }
 }
 ```
 
-### 4. 리소스(Resource) 정의
+### 리소스(Resource) 정의
 
-리소스는 서비스 내의 메서드에 `@McpResource` 데코레이터를 사용하여 정의합니다. URI 템플릿을 지원합니다.
+메서드에 `@McpResource` 데코레이터를 사용하며, URI 템플릿(`{param}`)을 지원합니다.
 
 ```typescript
-import { Injectable } from '@nestjs/common';
-import { McpResource } from '@jissp/nestjs-mcp-server';
-
 @Injectable()
 export class MyResourceService {
   @McpResource({
-    uri: 'file://{path}',
-    name: 'system-file',
-    description: '시스템 파일을 읽어옵니다.',
-    mimeType: 'text/plain',
+    uri: 'docs://{topic}',
+    name: 'documentation',
+    description: '주제별 문서를 제공합니다.',
+    mimeType: 'text/markdown',
   })
-  async getFileContent(request: any) {
-    const { path } = request.params.arguments;
-    // 파일 읽기 로직...
-    return `Content of ${path}`;
+  async getDoc(request: any) {
+    const { topic } = request.params.arguments;
+    return `Content for ${topic}...`;
   }
 }
 ```
 
-## API 레퍼런스
-
-### McpServerModule
-
-#### `forRoot()`
-
-MCP 서버의 핵심 기능(SSE 스트림, JSON-RPC 처리 등)을 전역 모듈로 등록합니다.
-
-#### `forFeature(options: McpServerFeatureOptions)`
-
-특정 도구(Tool)나 리소스(Resource)를 담당할 프로바이더를 등록합니다.
-
-- `executors`: `BaseExecutor`를 구현하거나 MCP 데코레이터가 사용된 프로바이더 배열.
-- `imports`: (선택) `executors`가 의존하는 다른 모듈들.
-
-### 데코레이터
-
-#### `@McpTool(options: McpToolOptions)`
-
-메서드를 MCP 도구로 등록합니다.
-
-```typescript
-{
-  name: string;           // 도구 이름 (필수)
-  description ? : string;   // 도구 설명
-  inputSchema ? : any;      // JSON Schema 형식의 입력 파라미터 정의 또는 DTO 클래스
-}
-```
-
-#### `@McpSchemaProperty(options: McpSchemaPropertyOptions)`
-
-입력 파라미터 DTO의 속성을 정의하여 자동으로 JSON Schema를 생성합니다.
-
-```typescript
-{
-  type: string;           // 데이터 타입 (예: 'string', 'number', 'boolean')
-  description: string;    // 속성 설명
-  isRequired: boolean;    // 필수 여부
-}
-```
-
-#### `@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 결과 반환
+1.  **SSE 연결**: 클라이언트가 `GET /mcp/sse`에 접속하여 서버와 연결을 수립합니다.
+2.  **엔드포인트 통지**: 서버는 연결 성공 시 클라이언트에게 메시지를 보낼 POST 엔드포인트(` /mcp/message?sessionId=...`)를 알립니다.
+3.  **메시지 전송**: 클라이언트가 도구 실행 등을 요청할 때 해당 POST 엔드포인트로 JSON-RPC 메시지를 보냅니다.
+4.  **핸들러 실행**: `McpServerService`가 SDK를 통해 요청을 해석하고, `McpMetadataRegistryService`에 등록된 핸들러를 찾아 실행합니다.
+5.  **응답 반환**: 실행 결과가 SSE 스트림을 통해 다시 클라이언트에게 전달됩니다.

package/dist/decorators/mcp-schema-property.decorator.d.ts

@@ -1,7 +1,12 @@
+import { ConstructorType } from '@jissp/metadata-scanner';
+import { InputSchemaProperty } from './mcp-tool.decorator';
 export declare const MCP_SCHEMA_PROPERTIES_METADATA = "MCP_SCHEMA_PROPERTIES_METADATA";
 export interface McpSchemaPropertyOptions {
     type: string;
     description: string;
     isRequired: boolean;
+    enum?: (string | number)[];
+    items?: ConstructorType | InputSchemaProperty;
+    properties?: ConstructorType;
 }
 export declare const McpSchemaProperty: (options?: McpSchemaPropertyOptions | undefined) => (...args: [target: Object, propertyKey: string | symbol]) => void;

package/dist/decorators/mcp-schema-property.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-schema-property.decorator.js","sourceRoot":"","sources":["../../lib/mcp-server/decorators/mcp-schema-property.decorator.ts"],"names":[],"mappings":";;;AAAA,8DAAkE;AAErD,QAAA,8BAA8B,GAAG,gCAAgC,CAAC;AAQlE,QAAA,iBAAiB,GAC5B,IAAA,0CAAuB,EACrB,sCAA8B,CAC/B,CAAC"}
+{"version":3,"file":"mcp-schema-property.decorator.js","sourceRoot":"","sources":["../../lib/mcp-server/decorators/mcp-schema-property.decorator.ts"],"names":[],"mappings":";;;AAAA,8DAGiC;AAGpB,QAAA,8BAA8B,GAAG,gCAAgC,CAAC;AAmBlE,QAAA,iBAAiB,GAC5B,IAAA,0CAAuB,EACrB,sCAA8B,CAC/B,CAAC"}

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

@@ -12,6 +12,10 @@ export interface JsonSchema {
 export interface InputSchemaProperty {
     type: string;
     description?: string;
+    enum?: (string | number)[];
+    items?: InputSchemaProperty;
+    properties?: InputSchemaProperties;
+    required?: string[];
 }
 export type InputSchemaProperties = Record<string, InputSchemaProperty>;
 export declare const McpTool: import("@nestjs/core").ReflectableDecorator<McpToolOptions, McpToolOptions>;

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-tool.decorator.js","sourceRoot":"","sources":["../../lib/mcp-server/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":";;;AAAA,uCAAyC;AAsB5B,QAAA,OAAO,GAAG,gBAAS,CAAC,eAAe,EAAkB,CAAC"}
+{"version":3,"file":"mcp-tool.decorator.js","sourceRoot":"","sources":["../../lib/mcp-server/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":";;;AAAA,uCAAyC;AA0B5B,QAAA,OAAO,GAAG,gBAAS,CAAC,eAAe,EAAkB,CAAC"}

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export * from './mcp-metadata-input-schema.builder';
 export * from './mcp-server.controller';
 export * from './mcp-server.service';
 export * from './mcp-server.module';
+export * from './transports/sse-http-transport';

package/dist/index.js

@@ -23,4 +23,5 @@ __exportStar(require("./mcp-metadata-input-schema.builder"), exports);
 __exportStar(require("./mcp-server.controller"), exports);
 __exportStar(require("./mcp-server.service"), exports);
 __exportStar(require("./mcp-server.module"), exports);
+__exportStar(require("./transports/sse-http-transport"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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,sEAAoD;AACpD,0DAAwC;AACxC,uDAAqC;AACrC,sDAAoC"}
+{"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,sEAAoD;AACpD,0DAAwC;AACxC,uDAAqC;AACrC,sDAAoC;AACpC,kEAAgD"}

package/dist/mcp-metadata-input-schema.builder.d.ts

@@ -6,5 +6,6 @@ export declare class McpMetadataInputSchemaBuilder {
     build(mcpToolOptions: McpToolOptions): JsonSchema | undefined;
     private generateInputSchema;
     private buildSchemaProperties;
+    private toInputSchemaProperty;
     private buildRequired;
 }

package/dist/mcp-metadata-input-schema.builder.js

@@ -35,13 +35,33 @@ let McpMetadataInputSchemaBuilder = class McpMetadataInputSchemaBuilder {
     buildSchemaProperties(propertiesMetadata) {
         const entries = propertiesMetadata.map(({ key, metadata }) => [
             key,
-            {
-                type: metadata.type,
-                description: metadata.description,
-            },
+            this.toInputSchemaProperty(metadata),
         ]);
         return Object.fromEntries(entries);
     }
+    toInputSchemaProperty(options) {
+        const property = {
+            type: options.type,
+            description: options.description,
+        };
+        if (options.enum) {
+            property.enum = options.enum;
+        }
+        if (options.items !== undefined) {
+            property.items = (0, metadata_scanner_1.isConstructorType)(options.items)
+                ? this.generateInputSchema(options.items)
+                : options.items;
+        }
+        if (options.properties !== undefined &&
+            (0, metadata_scanner_1.isConstructorType)(options.properties)) {
+            const nested = this.generateInputSchema(options.properties);
+            property.properties = nested.properties;
+            if (nested.required && nested.required.length > 0) {
+                property.required = nested.required;
+            }
+        }
+        return property;
+    }
     buildRequired(propertiesMetadata) {
         const filteredEntries = propertiesMetadata.filter(({ metadata: { isRequired } }) => {
             return isRequired;

package/dist/mcp-metadata-input-schema.builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-metadata-input-schema.builder.js","sourceRoot":"","sources":["../lib/mcp-server/mcp-metadata-input-schema.builder.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,8DAKiC;AACjC,6CAOsB;AAGf,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAErB;IADnB,YACmB,sBAA8C;QAA9C,2BAAsB,GAAtB,sBAAsB,CAAwB;IAC9D,CAAC;IAEG,KAAK,CAAC,cAA8B;QACzC,IAAI,CAAC,IAAA,oCAAiB,EAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,OAAO,cAAc,CAAC,WAAW,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9D,CAAC;IAEO,mBAAmB,CAAC,gBAAiC;QAC3D,MAAM,UAAU,GACd,IAAI,CAAC,sBAAsB,CAAC,cAAc,CACxC,2CAA8B,EAC9B,gBAAgB,CACjB,CAAC;QAEJ,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC;YAClD,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;SACzC,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAC3B,kBAAuE;QAEvE,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CACpC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAiC,EAAE,CAAC;YACpD,GAAG;YACH;gBACE,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;aAClC;SACF,CACF,CAAC;QAEF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAEO,aAAa,CACnB,kBAAuE;QAEvE,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAC/C,CAAC,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE;YAC/B,OAAO,UAAU,CAAC;QACpB,CAAC,CACF,CAAC;QAEF,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AAtDY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,mBAAU,GAAE;qCAGgC,yCAAsB;GAFtD,6BAA6B,CAsDzC"}
+{"version":3,"file":"mcp-metadata-input-schema.builder.js","sourceRoot":"","sources":["../lib/mcp-server/mcp-metadata-input-schema.builder.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,8DAKiC;AACjC,6CAOsB;AAGf,IAAM,6BAA6B,GAAnC,MAAM,6BAA6B;IAErB;IADnB,YACmB,sBAA8C;QAA9C,2BAAsB,GAAtB,sBAAsB,CAAwB;IAC9D,CAAC;IAEG,KAAK,CAAC,cAA8B;QACzC,IAAI,CAAC,IAAA,oCAAiB,EAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,OAAO,cAAc,CAAC,WAAW,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC9D,CAAC;IAEO,mBAAmB,CAAC,gBAAiC;QAC3D,MAAM,UAAU,GACd,IAAI,CAAC,sBAAsB,CAAC,cAAc,CACxC,2CAA8B,EAC9B,gBAAgB,CACjB,CAAC;QAEJ,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC;YAClD,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC;SACzC,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAC3B,kBAAuE;QAEvE,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CACpC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAiC,EAAE,CAAC;YACpD,GAAG;YACH,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC;SACrC,CACF,CAAC;QAEF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAEO,qBAAqB,CAC3B,OAAiC;QAEjC,MAAM,QAAQ,GAAwB;YACpC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;QAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC/B,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,QAAQ,CAAC,KAAK,GAAG,IAAA,oCAAiB,EAAC,OAAO,CAAC,KAAK,CAAC;gBAC/C,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC;gBACzC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,CAAC;QAED,IACE,OAAO,CAAC,UAAU,KAAK,SAAS;YAChC,IAAA,oCAAiB,EAAC,OAAO,CAAC,UAAU,CAAC,EACrC,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5D,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;YACxC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YACtC,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,aAAa,CACnB,kBAAuE;QAEvE,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAC/C,CAAC,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE;YAC/B,OAAO,UAAU,CAAC;QACpB,CAAC,CACF,CAAC;QAEF,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AAnFY,sEAA6B;wCAA7B,6BAA6B;IADzC,IAAA,mBAAU,GAAE;qCAGgC,yCAAsB;GAFtD,6BAA6B,CAmFzC"}

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

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

package/dist/mcp-server.controller.js

@@ -14,49 +14,53 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.McpServerController = void 0;
 const common_1 = require("@nestjs/common");
-const rxjs_1 = require("rxjs");
-const guards_1 = require("./guards");
 const mcp_server_service_1 = require("./mcp-server.service");
+const sse_http_transport_1 = require("./transports/sse-http-transport");
 let McpServerController = class McpServerController {
     mcpService;
-    eventSubject = new rxjs_1.Subject();
+    transportMap = new Map();
     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 sse(req, res) {
+        const transport = new sse_http_transport_1.SseHttpTransport('/mcp/message');
+        const server = this.mcpService.createConfiguredServer();
+        transport.onclose = () => {
+            this.transportMap.delete(transport.sessionId);
+        };
+        transport.attachResponse(res);
+        await server.connect(transport);
+        this.transportMap.set(transport.sessionId, transport);
+        req.on('close', () => transport.close());
     }
-    async handleIncomingMessage(body, res) {
-        const response = await this.mcpService.handleMessage(body);
-        if (!response) {
-            return res.status(common_1.HttpStatus.ACCEPTED).send();
+    async handleMessage(req, res) {
+        const sessionId = req.query['sessionId'];
+        const transport = this.transportMap.get(sessionId);
+        if (!transport) {
+            return res
+                .status(common_1.HttpStatus.NOT_FOUND)
+                .json({ error: 'Session not found' });
         }
-        if (body.method === 'initialize') {
-            res.setHeader('MCP-Session-Id', crypto.randomUUID());
-        }
-        return res.status(common_1.HttpStatus.OK).json(response.result);
+        await transport.handlePostMessage(req, res);
     }
 };
 exports.McpServerController = McpServerController;
 __decorate([
-    (0, common_1.Sse)(),
-    (0, common_1.Get)(),
+    (0, common_1.Get)('sse'),
     __param(0, (0, common_1.Req)()),
+    __param(1, (0, common_1.Res)()),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", rxjs_1.Observable)
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
 ], McpServerController.prototype, "sse", null);
 __decorate([
-    (0, common_1.UseGuards)(guards_1.McpSessionIdGuard),
-    (0, common_1.Post)(),
-    __param(0, (0, common_1.Body)()),
+    (0, common_1.Post)('message'),
+    __param(0, (0, common_1.Req)()),
     __param(1, (0, common_1.Res)()),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object, Object]),
     __metadata("design:returntype", Promise)
-], McpServerController.prototype, "handleIncomingMessage", null);
+], McpServerController.prototype, "handleMessage", null);
 exports.McpServerController = McpServerController = __decorate([
     (0, common_1.Controller)('mcp'),
     __metadata("design:paramtypes", [mcp_server_service_1.McpServerService])

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.controller.js","sourceRoot":"","sources":["../lib/mcp-server/mcp-server.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAWwB;AAExB,+BAA2C;AAC3C,qCAA6C;AAE7C,6DAAwD;AAGjD,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"}
+{"version":3,"file":"mcp-server.controller.js","sourceRoot":"","sources":["../lib/mcp-server/mcp-server.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA6E;AAE7E,6DAAwD;AACxD,wEAAmE;AAG5D,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAGD;IAFZ,YAAY,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEpE,YAA6B,UAA4B;QAA5B,eAAU,GAAV,UAAU,CAAkB;IAAG,CAAC;IAGvD,AAAN,KAAK,CAAC,GAAG,CAAQ,GAAY,EAAS,GAAa;QACjD,MAAM,SAAS,GAAG,IAAI,qCAAgB,CAAC,cAAc,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAC;QAExD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;YACvB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC,CAAC;QAEF,SAAS,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAEtD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IAGK,AAAN,KAAK,CAAC,aAAa,CAAQ,GAAY,EAAS,GAAa;QAC3D,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,CAAW,CAAC;QACnD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEnD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,GAAG;iBACP,MAAM,CAAC,mBAAU,CAAC,SAAS,CAAC;iBAC5B,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAA;AAlCY,kDAAmB;AAMxB;IADL,IAAA,YAAG,EAAC,KAAK,CAAC;IACA,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,YAAG,GAAE,CAAA;;;;8CAapC;AAGK;IADL,IAAA,aAAI,EAAC,SAAS,CAAC;IACK,WAAA,IAAA,YAAG,GAAE,CAAA;IAAgB,WAAA,IAAA,YAAG,GAAE,CAAA;;;;wDAW9C;8BAjCU,mBAAmB;IAD/B,IAAA,mBAAU,EAAC,KAAK,CAAC;qCAIyB,qCAAgB;GAH9C,mBAAmB,CAkC/B"}

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

@@ -1,18 +1,7 @@
-import { JsonRpcErrorResult, JsonRpcRequest, JsonRpcResult } from './mcp-server.types';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 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;
+    createConfiguredServer(): Server;
 }
-export {};

package/dist/mcp-server.service.js

@@ -11,118 +11,70 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.McpServerService = void 0;
 const common_1 = require("@nestjs/common");
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 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 instanceof Error ? error.message : 'Unknown error',
-                    },
-                },
-            };
-        }
-    }
-    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, {
+    createConfiguredServer() {
+        const server = new index_js_1.Server({ name: 'nestjs-mcp-server', version: '1.0.0' }, { capabilities: { tools: {}, resources: {} } });
+        server.setRequestHandler(types_js_1.ListToolsRequestSchema, () => ({
             tools: this.registry.getTools().map((t) => ({
                 name: t.name,
                 description: t.description,
-                inputSchema: t.inputSchema || { type: 'object' },
+                inputSchema: t.inputSchema || {
+                    type: 'object',
+                    properties: {},
+                },
             })),
-        });
-    }
-    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),
+        }));
+        server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
+            const executor = this.registry.getToolExecutor(req.params.name);
+            if (!executor) {
+                throw new Error(`Tool not found: ${req.params.name}`);
+            }
+            const result = await executor.execute({
+                jsonrpc: '2.0',
+                id: undefined,
+                method: 'tools/call',
+                params: {
+                    name: req.params.name,
+                    arguments: req.params.arguments ?? {},
                 },
-            ],
-            isError: false,
+            });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result) }],
+            };
         });
-    }
-    resourceList({ id }) {
-        return this.wrapResult(id, {
+        server.setRequestHandler(types_js_1.ListResourcesRequestSchema, () => ({
             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: {
+        }));
+        server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (req) => {
+            const uri = req.params.uri;
+            const match = this.registry.getResourceHandler(uri);
+            if (!match) {
+                throw new Error(`Resource not found: ${uri}`);
+            }
+            const result = await match.handler({
                 jsonrpc: '2.0',
-                id,
-                result,
-            },
-        };
+                id: undefined,
+                method: 'resources/read',
+                params: { arguments: match.params },
+            });
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'application/json',
+                        text: JSON.stringify(result),
+                    },
+                ],
+            };
+        });
+        return server;
     }
 };
 exports.McpServerService = McpServerService;

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

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

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

@@ -8,11 +8,9 @@ export interface McpServerConfig {
 export interface McpServerFeatureOptions extends Pick<ModuleMetadata, 'imports'> {
     executors: Provider<BaseExecutor>[];
 }
-export interface CommonJsonRpc {
+export interface JsonRpcRequest<T = any> {
     jsonrpc: '2.0';
     id?: number | string;
-}
-export interface JsonRpcRequest<T = any> extends CommonJsonRpc {
     method: string;
     params: T;
 }
@@ -20,12 +18,3 @@ export type JsonRpcToolRequest<T = unknown> = JsonRpcRequest<{
     name: string;
     arguments: T;
 }>;
-export interface JsonRpcResourceParams {
-    uri: string;
-}
-export interface JsonRpcResult<T = unknown> extends CommonJsonRpc {
-    result: T;
-}
-export interface JsonRpcErrorResult<T = unknown> extends CommonJsonRpc {
-    error: T;
-}

package/dist/transports/sse-http-transport.d.ts

@@ -0,0 +1,18 @@
+import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { JSONRPCMessage } from '@modelcontextprotocol/sdk/types.js';
+import type { Request, Response } from 'express';
+export declare class SseHttpTransport implements Transport {
+    private readonly _endpoint;
+    private _sessionId;
+    private _res;
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: JSONRPCMessage) => void;
+    constructor(_endpoint: string);
+    get sessionId(): string;
+    attachResponse(res: Response): void;
+    start(): Promise<void>;
+    send(message: JSONRPCMessage): Promise<void>;
+    close(): Promise<void>;
+    handlePostMessage(req: Request, res: Response): Promise<void>;
+}

package/dist/transports/sse-http-transport.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SseHttpTransport = void 0;
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const node_crypto_1 = require("node:crypto");
+class SseHttpTransport {
+    _endpoint;
+    _sessionId;
+    _res = null;
+    onclose;
+    onerror;
+    onmessage;
+    constructor(_endpoint) {
+        this._endpoint = _endpoint;
+        this._sessionId = (0, node_crypto_1.randomUUID)();
+    }
+    get sessionId() {
+        return this._sessionId;
+    }
+    attachResponse(res) {
+        this._res = res;
+        res.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            Connection: 'keep-alive',
+        });
+        res.write(`event: endpoint\ndata: ${this._endpoint}?sessionId=${this._sessionId}\n\n`);
+        res.on('close', () => {
+            this._res = null;
+            this.onclose?.();
+        });
+    }
+    async start() {
+    }
+    async send(message) {
+        if (!this._res) {
+            throw new Error('SSE connection not established');
+        }
+        this._res.write(`event: message\ndata: ${JSON.stringify(message)}\n\n`);
+    }
+    async close() {
+        this._res?.end();
+        this._res = null;
+        this.onclose?.();
+    }
+    async handlePostMessage(req, res) {
+        if (!this._res) {
+            res.writeHead(500).end('SSE connection not established');
+            return;
+        }
+        let body;
+        try {
+            body = req.body;
+            if (!body || typeof body !== 'object') {
+                throw new Error('Invalid body');
+            }
+        }
+        catch (error) {
+            res.writeHead(400).end(String(error));
+            this.onerror?.(error);
+            return;
+        }
+        try {
+            const message = types_js_1.JSONRPCMessageSchema.parse(body);
+            this.onmessage?.(message);
+        }
+        catch (error) {
+            res.writeHead(400).end(`Invalid message: ${JSON.stringify(body)}`);
+            this.onerror?.(error);
+            return;
+        }
+        res.writeHead(202).end('Accepted');
+    }
+}
+exports.SseHttpTransport = SseHttpTransport;
+//# sourceMappingURL=sse-http-transport.js.map

package/dist/transports/sse-http-transport.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jissp/nestjs-mcp-server",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "NestJS-based MCP Server with metadata scanning support",
   "author": "jissp <jisspant@gmail.com>",
   "private": false,
@@ -50,7 +50,9 @@
     "rxjs": "^7.8.1"
   },
   "dependencies": {
-    "@jissp/metadata-scanner": "^0.0.4"
+    "@jissp/metadata-scanner": "^0.0.4",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@nestjs/platform-express": "^11.1.18"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.2.0",