@jissp/nestjs-mcp-server 0.0.4 → 0.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/README.md +58 -141
  2. package/dist/base.executor.js.map +1 -0
  3. package/dist/decorators/index.js.map +1 -0
  4. package/dist/decorators/mcp-resource.decorator.js.map +1 -0
  5. package/dist/{lib/mcp-server/decorators → decorators}/mcp-schema-property.decorator.d.ts +1 -1
  6. package/dist/{lib/mcp-server/decorators → decorators}/mcp-schema-property.decorator.js +1 -1
  7. package/dist/decorators/mcp-schema-property.decorator.js.map +1 -0
  8. package/dist/decorators/mcp-tool.decorator.js.map +1 -0
  9. package/dist/guards/index.js.map +1 -0
  10. package/dist/guards/mcp-session-id.guard.js.map +1 -0
  11. package/dist/{lib/mcp-server/index.d.ts → index.d.ts} +1 -0
  12. package/dist/{lib/mcp-server/index.js → index.js} +1 -0
  13. package/dist/index.js.map +1 -0
  14. package/dist/{lib/mcp-server/mcp-metadata-input-schema.builder.d.ts → mcp-metadata-input-schema.builder.d.ts} +1 -1
  15. package/dist/{lib/mcp-server/mcp-metadata-input-schema.builder.js → mcp-metadata-input-schema.builder.js} +1 -1
  16. package/dist/mcp-metadata-input-schema.builder.js.map +1 -0
  17. package/dist/{lib/mcp-server/mcp-metadata-registry.service.d.ts → mcp-metadata-registry.service.d.ts} +1 -1
  18. package/dist/{lib/mcp-server/mcp-metadata-registry.service.js → mcp-metadata-registry.service.js} +1 -1
  19. package/dist/mcp-metadata-registry.service.js.map +1 -0
  20. package/dist/mcp-server.controller.d.ts +9 -0
  21. package/dist/{lib/mcp-server/mcp-server.controller.js → mcp-server.controller.js} +27 -23
  22. package/dist/mcp-server.controller.js.map +1 -0
  23. package/dist/{lib/mcp-server/mcp-server.module.js → mcp-server.module.js} +1 -1
  24. package/dist/mcp-server.module.js.map +1 -0
  25. package/dist/mcp-server.service.d.ts +7 -0
  26. package/dist/mcp-server.service.js +85 -0
  27. package/dist/mcp-server.service.js.map +1 -0
  28. package/dist/{lib/mcp-server/mcp-server.types.d.ts → mcp-server.types.d.ts} +1 -12
  29. package/dist/mcp-server.types.js.map +1 -0
  30. package/dist/transports/sse-http-transport.d.ts +18 -0
  31. package/dist/transports/sse-http-transport.js +76 -0
  32. package/dist/transports/sse-http-transport.js.map +1 -0
  33. package/package.json +19 -18
  34. package/dist/lib/index.d.ts +0 -2
  35. package/dist/lib/index.js +0 -19
  36. package/dist/lib/index.js.map +0 -1
  37. package/dist/lib/mcp-server/base.executor.js.map +0 -1
  38. package/dist/lib/mcp-server/decorators/index.js.map +0 -1
  39. package/dist/lib/mcp-server/decorators/mcp-resource.decorator.js.map +0 -1
  40. package/dist/lib/mcp-server/decorators/mcp-schema-property.decorator.js.map +0 -1
  41. package/dist/lib/mcp-server/decorators/mcp-tool.decorator.js.map +0 -1
  42. package/dist/lib/mcp-server/guards/index.js.map +0 -1
  43. package/dist/lib/mcp-server/guards/mcp-session-id.guard.js.map +0 -1
  44. package/dist/lib/mcp-server/index.js.map +0 -1
  45. package/dist/lib/mcp-server/mcp-metadata-input-schema.builder.js.map +0 -1
  46. package/dist/lib/mcp-server/mcp-metadata-registry.service.js.map +0 -1
  47. package/dist/lib/mcp-server/mcp-server.controller.d.ts +0 -12
  48. package/dist/lib/mcp-server/mcp-server.controller.js.map +0 -1
  49. package/dist/lib/mcp-server/mcp-server.module.js.map +0 -1
  50. package/dist/lib/mcp-server/mcp-server.service.d.ts +0 -18
  51. package/dist/lib/mcp-server/mcp-server.service.js +0 -133
  52. package/dist/lib/mcp-server/mcp-server.service.js.map +0 -1
  53. package/dist/lib/mcp-server/mcp-server.types.js.map +0 -1
  54. package/dist/lib/metadata-scanner/decorators/create-property.decorator.d.ts +0 -5
  55. package/dist/lib/metadata-scanner/decorators/create-property.decorator.js +0 -35
  56. package/dist/lib/metadata-scanner/decorators/create-property.decorator.js.map +0 -1
  57. package/dist/lib/metadata-scanner/decorators/index.d.ts +0 -1
  58. package/dist/lib/metadata-scanner/decorators/index.js +0 -18
  59. package/dist/lib/metadata-scanner/decorators/index.js.map +0 -1
  60. package/dist/lib/metadata-scanner/index.d.ts +0 -5
  61. package/dist/lib/metadata-scanner/index.js +0 -22
  62. package/dist/lib/metadata-scanner/index.js.map +0 -1
  63. package/dist/lib/metadata-scanner/metadata-scanner.module.d.ts +0 -2
  64. package/dist/lib/metadata-scanner/metadata-scanner.module.js +0 -23
  65. package/dist/lib/metadata-scanner/metadata-scanner.module.js.map +0 -1
  66. package/dist/lib/metadata-scanner/metadata-scanner.service.d.ts +0 -11
  67. package/dist/lib/metadata-scanner/metadata-scanner.service.js +0 -86
  68. package/dist/lib/metadata-scanner/metadata-scanner.service.js.map +0 -1
  69. package/dist/lib/metadata-scanner/metadata-scanner.types.d.ts +0 -16
  70. package/dist/lib/metadata-scanner/metadata-scanner.types.js +0 -3
  71. package/dist/lib/metadata-scanner/metadata-scanner.types.js.map +0 -1
  72. package/dist/lib/metadata-scanner/utils/index.d.ts +0 -1
  73. package/dist/lib/metadata-scanner/utils/index.js +0 -18
  74. package/dist/lib/metadata-scanner/utils/index.js.map +0 -1
  75. package/dist/lib/metadata-scanner/utils/is-constructor-type.d.ts +0 -2
  76. package/dist/lib/metadata-scanner/utils/is-constructor-type.js +0 -7
  77. package/dist/lib/metadata-scanner/utils/is-constructor-type.js.map +0 -1
  78. /package/dist/{lib/mcp-server/base.executor.d.ts → base.executor.d.ts} +0 -0
  79. /package/dist/{lib/mcp-server/base.executor.js → base.executor.js} +0 -0
  80. /package/dist/{lib/mcp-server/decorators → decorators}/index.d.ts +0 -0
  81. /package/dist/{lib/mcp-server/decorators → decorators}/index.js +0 -0
  82. /package/dist/{lib/mcp-server/decorators → decorators}/mcp-resource.decorator.d.ts +0 -0
  83. /package/dist/{lib/mcp-server/decorators → decorators}/mcp-resource.decorator.js +0 -0
  84. /package/dist/{lib/mcp-server/decorators → decorators}/mcp-tool.decorator.d.ts +0 -0
  85. /package/dist/{lib/mcp-server/decorators → decorators}/mcp-tool.decorator.js +0 -0
  86. /package/dist/{lib/mcp-server/guards → guards}/index.d.ts +0 -0
  87. /package/dist/{lib/mcp-server/guards → guards}/index.js +0 -0
  88. /package/dist/{lib/mcp-server/guards → guards}/mcp-session-id.guard.d.ts +0 -0
  89. /package/dist/{lib/mcp-server/guards → guards}/mcp-session-id.guard.js +0 -0
  90. /package/dist/{lib/mcp-server/mcp-server.module.d.ts → mcp-server.module.d.ts} +0 -0
  91. /package/dist/{lib/mcp-server/mcp-server.types.js → mcp-server.types.js} +0 -0
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # nestjs-mcp-server
2
2
 
3
- > **참고**: 이 프로젝트는 토이프로젝트 또는 개인적인 용도로 로컬 MCP 구현하기 위해 만든 Simple 모듈입니다.
4
- >
5
- NestJS 기반의 Model Context Protocol (MCP) 서버 라이브러리입니다.
3
+ > **참고**: 이 프로젝트는 NestJS 환경에서 Model Context Protocol (MCP) 서버를 간편하게 구축하기 위한 라이브러리입니다.
6
4
 
7
- 데코레이터와 메타데이터 스캐닝을 통해 MCP 리소스와 도구를 간편하게 정의하고 관리할 수 있습니다.
5
+ NestJS의 강력한 데코레이터와 메타데이터 스캐닝 기능을 활용하여 MCP 리소스(Resource)와 도구(Tool)를 정의하고 관리할 수 있습니다.
6
+
7
+ 최신 버전은 공식 `@modelcontextprotocol/sdk`를 기반으로 하며, **SSE(Server-Sent Events)** 전송 방식을 지원합니다.
8
8
 
9
9
  ## 설치
10
10
 
@@ -14,17 +14,17 @@ npm install @jissp/nestjs-mcp-server
14
14
 
15
15
  ## 주요 기능
16
16
 
17
- - **데코레이터 기반 정의**: `@McpTool`, `@McpResource`, `@McpSchemaProperty` 데코레이터로 리소스와 도구 정의
18
- - **자동 메타데이터 스캔**: 클래스와 메서드의 메타데이터 자동 수집
19
- - **Executor 패턴**: 커스텀 executor를 통한 확장 가능한 아키텍처
20
- - **JSON-RPC 통신**: 표준 JSON-RPC 2.0 프로토콜 지원
21
- - **세션 관리**: 세션 ID 기반 요청 추적 (Header: `mcp-session-id`)
17
+ - **공식 MCP SDK 기반**: `@modelcontextprotocol/sdk`를 사용하여 표준 규격 완벽 준수
18
+ - **SSE 전송 방식**: 실시간 양방향 통신을 위한 SSE(Server-Sent Events) 지원
19
+ - **데코레이터 기반 정의**: `@McpTool`, `@McpResource`, `@McpSchemaProperty`를 이용한 간결한 정의
20
+ - **자동 메타데이터 스캔**: 클래스와 메서드에 정의된 MCP 메타데이터 자동 수집 및 등록
21
+ - **Executor 패턴**: 비즈니스 로직을 분리하여 확장 가능한 구조 제공
22
22
 
23
23
  ## 빠른 시작
24
24
 
25
25
  ### 1. 전역 모듈 설정
26
26
 
27
- `AppModule`에서 `forRoot()`를 호출하여 MCP 서버의 핵심 인프라(Controller, Service 등)를 전역적으로 설정합니다.
27
+ `AppModule`에서 `McpServerModule.forRoot()`를 호출하여 MCP 서버 인프라를 설정합니다.
28
28
 
29
29
  ```typescript
30
30
  import { Module } from '@nestjs/common';
@@ -35,20 +35,14 @@ import { McpServerModule } from '@jissp/nestjs-mcp-server';
35
35
  McpServerModule.forRoot(),
36
36
  ],
37
37
  })
38
- export class AppModule {
39
- }
38
+ export class AppModule {}
40
39
  ```
41
40
 
42
41
  ### 2. 도구(Tool) 및 리소스(Resource) 등록
43
42
 
44
- `forFeature()`를 사용하여 특정 도구나 리소스를 구현한 `executors`를 등록합니다.
43
+ `forFeature()`를 사용하여 MCP 요소들을 구현한 프로바이더를 등록합니다.
45
44
 
46
45
  ```typescript
47
- import { Module } from '@nestjs/common';
48
- import { McpServerModule } from '@jissp/nestjs-mcp-server';
49
- import { MyToolExecutor } from './my-tool.executor';
50
- import { MyResourceService } from './my-resource.service';
51
-
52
46
  @Module({
53
47
  imports: [
54
48
  McpServerModule.forFeature({
@@ -56,25 +50,44 @@ import { MyResourceService } from './my-resource.service';
56
50
  }),
57
51
  ],
58
52
  })
59
- export class MyFeatureModule {
53
+ export class MyFeatureModule {}
54
+ ```
55
+
56
+ ### 3. 클라이언트 설정 (예: Claude Desktop)
57
+
58
+ 클라이언트(예: Claude Desktop)에서 이 서버를 사용하려면 다음과 같이 SSE 방식으로 설정해야 합니다.
59
+
60
+ **`config.json` 예시:**
61
+
62
+ ```json
63
+ {
64
+ "mcpServers": {
65
+ "my-nestjs-server": {
66
+ "command": "node",
67
+ "args": ["/path/to/your/server/dist/main.js"],
68
+ "env": {
69
+ "MCP_TRANSPORT": "sse",
70
+ "MCP_ENDPOINT": "http://localhost:3000/mcp/sse"
71
+ }
72
+ }
73
+ }
60
74
  }
61
75
  ```
62
76
 
63
- ### 3. 도구(Tool) 정의
77
+ *참고: 서버 주소는 기본적으로 `http://localhost:3000/mcp/sse`가 엔드포인트가 됩니다.*
64
78
 
65
- 도구는 클래스 메서드에 `@McpTool` 데코레이터를 사용하여 정의합니다. 입력 스키마는 직접 JSON Schema 객체로 전달하거나, `@McpSchemaProperty`가 적용된 클래스를 전달하여 자동으로 생성할 수 있습니다.
79
+ ## 정의 가이드
66
80
 
67
- #### JSON Schema 직접 정의 방식
81
+ ### 도구(Tool) 정의
68
82
 
69
- ```typescript
70
- import { Injectable } from '@nestjs/common';
71
- import { McpTool, JsonRpcCallRequest } from '@jissp/nestjs-mcp-server';
83
+ `BaseExecutor` 인터페이스를 구현하고 `@McpTool` 데코레이터를 사용합니다.
72
84
 
85
+ ```typescript
73
86
  @Injectable()
74
- export class MyToolExecutor {
87
+ export class CalculateSumExecutor implements BaseExecutor {
75
88
  @McpTool({
76
89
  name: 'calculate-sum',
77
- description: '두 숫자의 합을 계산합니다.',
90
+ description: '두 숫자의 합을 구합니다.',
78
91
  inputSchema: {
79
92
  type: 'object',
80
93
  properties: {
@@ -84,133 +97,37 @@ export class MyToolExecutor {
84
97
  required: ['a', 'b'],
85
98
  },
86
99
  })
87
- async execute(request: JsonRpcCallRequest) {
88
- const { a, b } = request.params.arguments as { a: number; b: number };
89
- return a + b;
90
- }
91
- }
92
- ```
93
-
94
- #### @McpSchemaProperty 클래스 기반 방식
95
-
96
- ```typescript
97
- import { Injectable } from '@nestjs/common';
98
- import { McpTool, McpSchemaProperty } from '@jissp/nestjs-mcp-server';
99
-
100
- export class CalculateSumDto {
101
- @McpSchemaProperty({
102
- type: 'number',
103
- description: '첫 번째 숫자',
104
- isRequired: true,
105
- })
106
- a: number;
107
-
108
- @McpSchemaProperty({
109
- type: 'number',
110
- description: '두 번째 숫자',
111
- isRequired: true,
112
- })
113
- b: number;
114
- }
115
-
116
- @Injectable()
117
- export class MyToolExecutor {
118
- @McpTool({
119
- name: 'calculate-sum',
120
- description: '두 숫자의 합을 계산합니다.',
121
- inputSchema: CalculateSumDto,
122
- })
123
- async execute(params: CalculateSumDto) {
124
- return params.a + params.b;
100
+ async execute(request: JsonRpcToolRequest) {
101
+ const { a, b } = request.params.arguments;
102
+ return { result: a + b };
125
103
  }
126
104
  }
127
105
  ```
128
106
 
129
- ### 4. 리소스(Resource) 정의
107
+ ### 리소스(Resource) 정의
130
108
 
131
- 리소스는 서비스 내의 메서드에 `@McpResource` 데코레이터를 사용하여 정의합니다. URI 템플릿을 지원합니다.
109
+ 메서드에 `@McpResource` 데코레이터를 사용하며, URI 템플릿(`{param}`)을 지원합니다.
132
110
 
133
111
  ```typescript
134
- import { Injectable } from '@nestjs/common';
135
- import { McpResource } from '@jissp/nestjs-mcp-server';
136
-
137
112
  @Injectable()
138
113
  export class MyResourceService {
139
114
  @McpResource({
140
- uri: 'file://{path}',
141
- name: 'system-file',
142
- description: '시스템 파일을 읽어옵니다.',
143
- mimeType: 'text/plain',
115
+ uri: 'docs://{topic}',
116
+ name: 'documentation',
117
+ description: '주제별 문서를 제공합니다.',
118
+ mimeType: 'text/markdown',
144
119
  })
145
- async getFileContent(request: any) {
146
- const { path } = request.params.arguments;
147
- // 파일 읽기 로직...
148
- return `Content of ${path}`;
120
+ async getDoc(request: any) {
121
+ const { topic } = request.params.arguments;
122
+ return `Content for ${topic}...`;
149
123
  }
150
124
  }
151
125
  ```
152
126
 
153
- ## API 레퍼런스
154
-
155
- ### McpServerModule
156
-
157
- #### `forRoot()`
158
-
159
- MCP 서버의 핵심 기능(SSE 스트림, JSON-RPC 처리 등)을 전역 모듈로 등록합니다.
160
-
161
- #### `forFeature(options: McpServerFeatureOptions)`
162
-
163
- 특정 도구(Tool)나 리소스(Resource)를 담당할 프로바이더를 등록합니다.
164
-
165
- - `executors`: `BaseExecutor`를 구현하거나 MCP 데코레이터가 사용된 프로바이더 배열.
166
- - `imports`: (선택) `executors`가 의존하는 다른 모듈들.
167
-
168
- ### 데코레이터
169
-
170
- #### `@McpTool(options: McpToolOptions)`
171
-
172
- 메서드를 MCP 도구로 등록합니다.
173
-
174
- ```typescript
175
- {
176
- name: string; // 도구 이름 (필수)
177
- description ? : string; // 도구 설명
178
- inputSchema ? : any; // JSON Schema 형식의 입력 파라미터 정의 또는 DTO 클래스
179
- }
180
- ```
181
-
182
- #### `@McpSchemaProperty(options: McpSchemaPropertyOptions)`
183
-
184
- 입력 파라미터 DTO의 속성을 정의하여 자동으로 JSON Schema를 생성합니다.
185
-
186
- ```typescript
187
- {
188
- type: string; // 데이터 타입 (예: 'string', 'number', 'boolean')
189
- description: string; // 속성 설명
190
- isRequired: boolean; // 필수 여부
191
- }
192
- ```
193
-
194
- #### `@McpResource(options: McpResourceOptions)`
195
-
196
- 메서드를 MCP 리소스로 등록합니다.
197
-
198
- ```typescript
199
- {
200
- uri: string; // 리소스 URI 템플릿 (필수, 예: 'myschema://{id}')
201
- name: string; // 리소스 이름 (필수)
202
- description ? : string; // 리소스 설명
203
- mimeType ? : string; // 리소스의 MIME 타입
204
- }
205
- ```
206
-
207
- ## 아키텍처
208
-
209
- ### 요청 흐름
127
+ ## 아키텍처 및 요청 흐름
210
128
 
211
- 1. **클라이언트 SSE 연결** `GET /mcp` (Header에 `mcp-session-id` 포함 권장)
212
- 2. **JSON-RPC 요청** `POST /mcp`
213
- 3. **McpServerController** 요청 수신 세션 검증 (`McpSessionIdGuard`)
214
- 4. **McpServerService** 메서드 핸들러 조회 `McpMetadataRegistryService` 참조
215
- 5. **Executor / Handler** `@McpTool` 클래스의 `execute` 또는 `@McpResource` 메서드 실행
216
- 6. **응답** → JSON-RPC 결과 반환
129
+ 1. **SSE 연결**: 클라이언트가 `GET /mcp/sse`에 접속하여 서버와 연결을 수립합니다.
130
+ 2. **엔드포인트 통지**: 서버는 연결 성공 시 클라이언트에게 메시지를 보낼 POST 엔드포인트(` /mcp/message?sessionId=...`)를 알립니다.
131
+ 3. **메시지 전송**: 클라이언트가 도구 실행 등을 요청할 해당 POST 엔드포인트로 JSON-RPC 메시지를 보냅니다.
132
+ 4. **핸들러 실행**: `McpServerService`가 SDK를 통해 요청을 해석하고, `McpMetadataRegistryService`에 등록된 핸들러를 찾아 실행합니다.
133
+ 5. **응답 반환**: 실행 결과가 SSE 스트림을 통해 다시 클라이언트에게 전달됩니다.
@@ -0,0 +1 @@
1
+ {"version":3,"file":"base.executor.js","sourceRoot":"","sources":["../lib/mcp-server/base.executor.ts"],"names":[],"mappings":""}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/mcp-server/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,2DAAyC;AACzC,kEAAgD"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-resource.decorator.js","sourceRoot":"","sources":["../../lib/mcp-server/decorators/mcp-resource.decorator.ts"],"names":[],"mappings":";;;AAAA,uCAAyC;AAS5B,QAAA,WAAW,GAAG,gBAAS,CAAC,eAAe,EAAsB,CAAC"}
@@ -4,4 +4,4 @@ export interface McpSchemaPropertyOptions {
4
4
  description: string;
5
5
  isRequired: boolean;
6
6
  }
7
- export declare const McpSchemaProperty: (options: McpSchemaPropertyOptions) => (...args: [target: Object, propertyKey: string | symbol]) => void;
7
+ export declare const McpSchemaProperty: (options?: McpSchemaPropertyOptions | undefined) => (...args: [target: Object, propertyKey: string | symbol]) => void;
@@ -1,7 +1,7 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.McpSchemaProperty = exports.MCP_SCHEMA_PROPERTIES_METADATA = void 0;
4
- const metadata_scanner_1 = require("../../metadata-scanner");
4
+ const metadata_scanner_1 = require("@jissp/metadata-scanner");
5
5
  exports.MCP_SCHEMA_PROPERTIES_METADATA = 'MCP_SCHEMA_PROPERTIES_METADATA';
6
6
  exports.McpSchemaProperty = (0, metadata_scanner_1.createPropertyDecorator)(exports.MCP_SCHEMA_PROPERTIES_METADATA);
7
7
  //# sourceMappingURL=mcp-schema-property.decorator.js.map
@@ -0,0 +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"}
@@ -0,0 +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"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/mcp-server/guards/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yDAAuC"}
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-session-id.guard.js","sourceRoot":"","sources":["../../lib/mcp-server/guards/mcp-session-id.guard.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAKwB;AAKjB,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"}
@@ -7,3 +7,4 @@ export * from './mcp-metadata-input-schema.builder';
7
7
  export * from './mcp-server.controller';
8
8
  export * from './mcp-server.service';
9
9
  export * from './mcp-server.module';
10
+ export * from './transports/sse-http-transport';
@@ -23,4 +23,5 @@ __exportStar(require("./mcp-metadata-input-schema.builder"), exports);
23
23
  __exportStar(require("./mcp-server.controller"), exports);
24
24
  __exportStar(require("./mcp-server.service"), exports);
25
25
  __exportStar(require("./mcp-server.module"), exports);
26
+ __exportStar(require("./transports/sse-http-transport"), exports);
26
27
  //# sourceMappingURL=index.js.map
@@ -0,0 +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;AACpC,kEAAgD"}
@@ -1,4 +1,4 @@
1
- import { MetadataScannerService } from '../metadata-scanner';
1
+ import { MetadataScannerService } from '@jissp/metadata-scanner';
2
2
  import { JsonSchema, McpToolOptions } from './decorators';
3
3
  export declare class McpMetadataInputSchemaBuilder {
4
4
  private readonly metadataScannerService;
@@ -11,7 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
11
11
  Object.defineProperty(exports, "__esModule", { value: true });
12
12
  exports.McpMetadataInputSchemaBuilder = void 0;
13
13
  const common_1 = require("@nestjs/common");
14
- const metadata_scanner_1 = require("../metadata-scanner");
14
+ const metadata_scanner_1 = require("@jissp/metadata-scanner");
15
15
  const decorators_1 = require("./decorators");
16
16
  let McpMetadataInputSchemaBuilder = class McpMetadataInputSchemaBuilder {
17
17
  metadataScannerService;
@@ -0,0 +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"}
@@ -1,5 +1,5 @@
1
1
  import { OnModuleInit } from '@nestjs/common';
2
- import { MetadataScannerService } from '../metadata-scanner';
2
+ import { MetadataScannerService } from '@jissp/metadata-scanner';
3
3
  import { McpResourceOptions, McpToolOptions } from './decorators';
4
4
  import { BaseExecutor } from './base.executor';
5
5
  import { McpMetadataInputSchemaBuilder } from './mcp-metadata-input-schema.builder';
@@ -11,7 +11,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
11
11
  Object.defineProperty(exports, "__esModule", { value: true });
12
12
  exports.McpMetadataRegistryService = void 0;
13
13
  const common_1 = require("@nestjs/common");
14
- const metadata_scanner_1 = require("../metadata-scanner");
14
+ const metadata_scanner_1 = require("@jissp/metadata-scanner");
15
15
  const decorators_1 = require("./decorators");
16
16
  const mcp_metadata_input_schema_builder_1 = require("./mcp-metadata-input-schema.builder");
17
17
  let McpMetadataRegistryService = class McpMetadataRegistryService {
@@ -0,0 +1 @@
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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"}
@@ -0,0 +1,9 @@
1
+ import type { Request, Response } from 'express';
2
+ import { McpServerService } from './mcp-server.service';
3
+ export declare class McpServerController {
4
+ private readonly mcpService;
5
+ private readonly transportMap;
6
+ constructor(mcpService: McpServerService);
7
+ sse(req: Request, res: Response): Promise<void>;
8
+ handleMessage(req: Request, res: Response): Promise<Response<any, Record<string, any>> | undefined>;
9
+ }
@@ -14,49 +14,53 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
14
14
  Object.defineProperty(exports, "__esModule", { value: true });
15
15
  exports.McpServerController = void 0;
16
16
  const common_1 = require("@nestjs/common");
17
- const rxjs_1 = require("rxjs");
18
- const guards_1 = require("./guards");
19
17
  const mcp_server_service_1 = require("./mcp-server.service");
18
+ const sse_http_transport_1 = require("./transports/sse-http-transport");
20
19
  let McpServerController = class McpServerController {
21
20
  mcpService;
22
- eventSubject = new rxjs_1.Subject();
21
+ transportMap = new Map();
23
22
  constructor(mcpService) {
24
23
  this.mcpService = mcpService;
25
24
  }
26
- sse(req) {
27
- const sessionId = req.headers['mcp-session-id'];
28
- console.log(`SSE Connected with Session ID: ${sessionId?.toString() ?? 'unknown'}`);
29
- return this.eventSubject.asObservable();
25
+ async sse(req, res) {
26
+ const transport = new sse_http_transport_1.SseHttpTransport('/mcp/message');
27
+ const server = this.mcpService.createConfiguredServer();
28
+ transport.onclose = () => {
29
+ this.transportMap.delete(transport.sessionId);
30
+ };
31
+ transport.attachResponse(res);
32
+ await server.connect(transport);
33
+ this.transportMap.set(transport.sessionId, transport);
34
+ req.on('close', () => transport.close());
30
35
  }
31
- async handleIncomingMessage(body, res) {
32
- const response = await this.mcpService.handleMessage(body);
33
- if (!response) {
34
- return res.status(common_1.HttpStatus.ACCEPTED).send();
36
+ async handleMessage(req, res) {
37
+ const sessionId = req.query['sessionId'];
38
+ const transport = this.transportMap.get(sessionId);
39
+ if (!transport) {
40
+ return res
41
+ .status(common_1.HttpStatus.NOT_FOUND)
42
+ .json({ error: 'Session not found' });
35
43
  }
36
- if (body.method === 'initialize') {
37
- res.setHeader('MCP-Session-Id', crypto.randomUUID());
38
- }
39
- return res.status(common_1.HttpStatus.OK).json(response.result);
44
+ await transport.handlePostMessage(req, res);
40
45
  }
41
46
  };
42
47
  exports.McpServerController = McpServerController;
43
48
  __decorate([
44
- (0, common_1.Sse)(),
45
- (0, common_1.Get)(),
49
+ (0, common_1.Get)('sse'),
46
50
  __param(0, (0, common_1.Req)()),
51
+ __param(1, (0, common_1.Res)()),
47
52
  __metadata("design:type", Function),
48
- __metadata("design:paramtypes", [Object]),
49
- __metadata("design:returntype", rxjs_1.Observable)
53
+ __metadata("design:paramtypes", [Object, Object]),
54
+ __metadata("design:returntype", Promise)
50
55
  ], McpServerController.prototype, "sse", null);
51
56
  __decorate([
52
- (0, common_1.UseGuards)(guards_1.McpSessionIdGuard),
53
- (0, common_1.Post)(),
54
- __param(0, (0, common_1.Body)()),
57
+ (0, common_1.Post)('message'),
58
+ __param(0, (0, common_1.Req)()),
55
59
  __param(1, (0, common_1.Res)()),
56
60
  __metadata("design:type", Function),
57
61
  __metadata("design:paramtypes", [Object, Object]),
58
62
  __metadata("design:returntype", Promise)
59
- ], McpServerController.prototype, "handleIncomingMessage", null);
63
+ ], McpServerController.prototype, "handleMessage", null);
60
64
  exports.McpServerController = McpServerController = __decorate([
61
65
  (0, common_1.Controller)('mcp'),
62
66
  __metadata("design:paramtypes", [mcp_server_service_1.McpServerService])
@@ -0,0 +1 @@
1
+ {"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"}
@@ -9,7 +9,7 @@ var McpServerModule_1;
9
9
  Object.defineProperty(exports, "__esModule", { value: true });
10
10
  exports.McpServerModule = void 0;
11
11
  const common_1 = require("@nestjs/common");
12
- const metadata_scanner_1 = require("../metadata-scanner");
12
+ const metadata_scanner_1 = require("@jissp/metadata-scanner");
13
13
  const mcp_server_controller_1 = require("./mcp-server.controller");
14
14
  const mcp_metadata_input_schema_builder_1 = require("./mcp-metadata-input-schema.builder");
15
15
  const mcp_metadata_registry_service_1 = require("./mcp-metadata-registry.service");
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-server.module.js","sourceRoot":"","sources":["../lib/mcp-server/mcp-server.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAuD;AACvD,8DAAgE;AAEhE,mEAA8D;AAC9D,2FAAoF;AACpF,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;gBACT,0DAA0B;gBAC1B,iEAA6B;gBAC7B,qCAAgB;aACjB;YACD,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;AAxBY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,eAAe,CAwB3B"}
@@ -0,0 +1,7 @@
1
+ import { Server } from '@modelcontextprotocol/sdk/server/index.js';
2
+ import { McpMetadataRegistryService } from './mcp-metadata-registry.service';
3
+ export declare class McpServerService {
4
+ private readonly registry;
5
+ constructor(registry: McpMetadataRegistryService);
6
+ createConfiguredServer(): Server;
7
+ }
@@ -0,0 +1,85 @@
1
+ "use strict";
2
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
+ 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;
6
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
7
+ };
8
+ var __metadata = (this && this.__metadata) || function (k, v) {
9
+ if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
+ };
11
+ Object.defineProperty(exports, "__esModule", { value: true });
12
+ exports.McpServerService = void 0;
13
+ const common_1 = require("@nestjs/common");
14
+ const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
15
+ const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
16
+ const mcp_metadata_registry_service_1 = require("./mcp-metadata-registry.service");
17
+ let McpServerService = class McpServerService {
18
+ registry;
19
+ constructor(registry) {
20
+ this.registry = registry;
21
+ }
22
+ createConfiguredServer() {
23
+ const server = new index_js_1.Server({ name: 'nestjs-mcp-server', version: '1.0.0' }, { capabilities: { tools: {}, resources: {} } });
24
+ server.setRequestHandler(types_js_1.ListToolsRequestSchema, () => ({
25
+ tools: this.registry.getTools().map((t) => ({
26
+ name: t.name,
27
+ description: t.description,
28
+ inputSchema: t.inputSchema || {
29
+ type: 'object',
30
+ properties: {},
31
+ },
32
+ })),
33
+ }));
34
+ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (req) => {
35
+ const executor = this.registry.getToolExecutor(req.params.name);
36
+ if (!executor) {
37
+ throw new Error(`Tool not found: ${req.params.name}`);
38
+ }
39
+ const result = await executor.execute({
40
+ jsonrpc: '2.0',
41
+ id: undefined,
42
+ method: 'tools/call',
43
+ params: {
44
+ name: req.params.name,
45
+ arguments: req.params.arguments ?? {},
46
+ },
47
+ });
48
+ return {
49
+ content: [{ type: 'text', text: JSON.stringify(result) }],
50
+ };
51
+ });
52
+ server.setRequestHandler(types_js_1.ListResourcesRequestSchema, () => ({
53
+ resources: this.registry.getResources(),
54
+ }));
55
+ server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (req) => {
56
+ const uri = req.params.uri;
57
+ const match = this.registry.getResourceHandler(uri);
58
+ if (!match) {
59
+ throw new Error(`Resource not found: ${uri}`);
60
+ }
61
+ const result = await match.handler({
62
+ jsonrpc: '2.0',
63
+ id: undefined,
64
+ method: 'resources/read',
65
+ params: { arguments: match.params },
66
+ });
67
+ return {
68
+ contents: [
69
+ {
70
+ uri,
71
+ mimeType: 'application/json',
72
+ text: JSON.stringify(result),
73
+ },
74
+ ],
75
+ };
76
+ });
77
+ return server;
78
+ }
79
+ };
80
+ exports.McpServerService = McpServerService;
81
+ exports.McpServerService = McpServerService = __decorate([
82
+ (0, common_1.Injectable)(),
83
+ __metadata("design:paramtypes", [mcp_metadata_registry_service_1.McpMetadataRegistryService])
84
+ ], McpServerService);
85
+ //# sourceMappingURL=mcp-server.service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-server.service.js","sourceRoot":"","sources":["../lib/mcp-server/mcp-server.service.ts"],"names":[],"mappings":"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"}
@@ -8,11 +8,9 @@ export interface McpServerConfig {
8
8
  export interface McpServerFeatureOptions extends Pick<ModuleMetadata, 'imports'> {
9
9
  executors: Provider<BaseExecutor>[];
10
10
  }
11
- export interface CommonJsonRpc {
11
+ export interface JsonRpcRequest<T = any> {
12
12
  jsonrpc: '2.0';
13
13
  id?: number | string;
14
- }
15
- export interface JsonRpcRequest<T = any> extends CommonJsonRpc {
16
14
  method: string;
17
15
  params: T;
18
16
  }
@@ -20,12 +18,3 @@ export type JsonRpcToolRequest<T = unknown> = JsonRpcRequest<{
20
18
  name: string;
21
19
  arguments: T;
22
20
  }>;
23
- export interface JsonRpcResourceParams {
24
- uri: string;
25
- }
26
- export interface JsonRpcResult<T = unknown> extends CommonJsonRpc {
27
- result: T;
28
- }
29
- export interface JsonRpcErrorResult<T = unknown> extends CommonJsonRpc {
30
- error: T;
31
- }
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-server.types.js","sourceRoot":"","sources":["../lib/mcp-server/mcp-server.types.ts"],"names":[],"mappings":""}