@mandujs/mcp 0.12.2 → 0.13.0
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.
- package/README.md +367 -367
- package/package.json +2 -2
- package/src/activity-monitor.ts +847 -847
- package/src/adapters/index.ts +20 -20
- package/src/adapters/monitor-adapter.ts +100 -100
- package/src/adapters/tool-adapter.ts +88 -88
- package/src/executor/error-handler.ts +250 -250
- package/src/executor/index.ts +22 -22
- package/src/executor/tool-executor.ts +148 -148
- package/src/hooks/config-watcher.ts +174 -174
- package/src/hooks/index.ts +23 -23
- package/src/hooks/mcp-hooks.ts +227 -227
- package/src/index.ts +106 -106
- package/src/logging/index.ts +15 -15
- package/src/logging/mcp-transport.ts +134 -134
- package/src/registry/index.ts +13 -13
- package/src/registry/mcp-tool-registry.ts +298 -298
- package/src/resources/skills/guides.ts +1136 -1136
- package/src/resources/skills/index.ts +12 -12
- package/src/resources/skills/loader.ts +218 -218
- package/src/resources/skills/mandu-composition/SKILL.md +91 -91
- package/src/resources/skills/mandu-composition/metadata.json +13 -13
- package/src/resources/skills/mandu-composition/rules/_sections.md +26 -26
- package/src/resources/skills/mandu-composition/rules/_template.md +77 -77
- package/src/resources/skills/mandu-composition/rules/comp-arch-avoid-boolean-props.md +146 -146
- package/src/resources/skills/mandu-composition/rules/comp-arch-compound-components.md +164 -164
- package/src/resources/skills/mandu-composition/rules/comp-island-event.md +161 -161
- package/src/resources/skills/mandu-composition/rules/comp-island-slot-split.md +167 -167
- package/src/resources/skills/mandu-composition/rules/comp-pattern-children.md +149 -149
- package/src/resources/skills/mandu-composition/rules/comp-state-context-interface.md +148 -148
- package/src/resources/skills/mandu-composition/rules/comp-state-lift-state.md +150 -150
- package/src/resources/skills/mandu-deployment/SKILL.md +92 -92
- package/src/resources/skills/mandu-deployment/_sections.md +41 -41
- package/src/resources/skills/mandu-deployment/_template.md +38 -38
- package/src/resources/skills/mandu-deployment/metadata.json +13 -13
- package/src/resources/skills/mandu-deployment/rules/deploy-build-bun.md +109 -109
- package/src/resources/skills/mandu-deployment/rules/deploy-build-output.md +115 -115
- package/src/resources/skills/mandu-deployment/rules/deploy-cicd-github.md +219 -219
- package/src/resources/skills/mandu-deployment/rules/deploy-docker-bun.md +150 -150
- package/src/resources/skills/mandu-deployment/rules/deploy-docker-compose.md +223 -223
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-fly.md +152 -152
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-render.md +179 -179
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-supabase.md +323 -323
- package/src/resources/skills/mandu-deployment/rules/deploy-platform-vercel.md +140 -140
- package/src/resources/skills/mandu-fs-routes/SKILL.md +82 -82
- package/src/resources/skills/mandu-fs-routes/metadata.json +12 -12
- package/src/resources/skills/mandu-fs-routes/rules/_sections.md +36 -36
- package/src/resources/skills/mandu-fs-routes/rules/_template.md +69 -69
- package/src/resources/skills/mandu-fs-routes/rules/routes-api-methods.md +65 -65
- package/src/resources/skills/mandu-fs-routes/rules/routes-dynamic-param.md +93 -93
- package/src/resources/skills/mandu-fs-routes/rules/routes-naming-page.md +55 -55
- package/src/resources/skills/mandu-guard/SKILL.md +129 -129
- package/src/resources/skills/mandu-guard/metadata.json +12 -12
- package/src/resources/skills/mandu-guard/rules/_sections.md +36 -36
- package/src/resources/skills/mandu-guard/rules/_template.md +82 -82
- package/src/resources/skills/mandu-guard/rules/guard-config-rules.md +100 -100
- package/src/resources/skills/mandu-guard/rules/guard-layer-direction.md +76 -76
- package/src/resources/skills/mandu-guard/rules/guard-preset-mandu.md +81 -81
- package/src/resources/skills/mandu-guard/rules/guard-validate-import.md +80 -80
- package/src/resources/skills/mandu-hydration/SKILL.md +91 -91
- package/src/resources/skills/mandu-hydration/metadata.json +12 -12
- package/src/resources/skills/mandu-hydration/rules/_sections.md +31 -31
- package/src/resources/skills/mandu-hydration/rules/_template.md +72 -72
- package/src/resources/skills/mandu-hydration/rules/hydration-data-event.md +109 -109
- package/src/resources/skills/mandu-hydration/rules/hydration-directive-use-client.md +55 -55
- package/src/resources/skills/mandu-hydration/rules/hydration-island-setup.md +113 -113
- package/src/resources/skills/mandu-hydration/rules/hydration-priority-visible.md +68 -68
- package/src/resources/skills/mandu-performance/SKILL.md +85 -85
- package/src/resources/skills/mandu-performance/metadata.json +14 -14
- package/src/resources/skills/mandu-performance/rules/_sections.md +31 -31
- package/src/resources/skills/mandu-performance/rules/_template.md +64 -64
- package/src/resources/skills/mandu-performance/rules/perf-async-defer-await.md +103 -103
- package/src/resources/skills/mandu-performance/rules/perf-async-parallel.md +95 -95
- package/src/resources/skills/mandu-performance/rules/perf-bun-file.md +124 -124
- package/src/resources/skills/mandu-performance/rules/perf-bun-serve.md +125 -125
- package/src/resources/skills/mandu-performance/rules/perf-bundle-imports.md +80 -80
- package/src/resources/skills/mandu-performance/rules/perf-bundle-island-lazy.md +145 -145
- package/src/resources/skills/mandu-performance/rules/perf-cache-react.md +98 -98
- package/src/resources/skills/mandu-performance/rules/perf-render-transitions.md +154 -154
- package/src/resources/skills/mandu-security/SKILL.md +87 -87
- package/src/resources/skills/mandu-security/metadata.json +13 -13
- package/src/resources/skills/mandu-security/rules/_sections.md +31 -31
- package/src/resources/skills/mandu-security/rules/_template.md +74 -74
- package/src/resources/skills/mandu-security/rules/sec-auth-guard.md +127 -127
- package/src/resources/skills/mandu-security/rules/sec-env-management.md +133 -133
- package/src/resources/skills/mandu-security/rules/sec-input-validate.md +148 -148
- package/src/resources/skills/mandu-security/rules/sec-protect-csrf.md +146 -146
- package/src/resources/skills/mandu-security/rules/sec-protect-headers.md +138 -138
- package/src/resources/skills/mandu-slot/SKILL.md +85 -85
- package/src/resources/skills/mandu-slot/metadata.json +12 -12
- package/src/resources/skills/mandu-slot/rules/_sections.md +36 -36
- package/src/resources/skills/mandu-slot/rules/_template.md +63 -63
- package/src/resources/skills/mandu-slot/rules/slot-basic-structure.md +38 -38
- package/src/resources/skills/mandu-slot/rules/slot-ctx-response.md +56 -56
- package/src/resources/skills/mandu-slot/rules/slot-guard-auth.md +59 -59
- package/src/resources/skills/mandu-slot/rules/slot-http-methods.md +64 -64
- package/src/resources/skills/mandu-styling/SKILL.md +154 -154
- package/src/resources/skills/mandu-styling/_sections.md +43 -43
- package/src/resources/skills/mandu-styling/_template.md +32 -32
- package/src/resources/skills/mandu-styling/metadata.json +15 -15
- package/src/resources/skills/mandu-styling/rules/style-component-compound.md +235 -235
- package/src/resources/skills/mandu-styling/rules/style-component-slots.md +255 -255
- package/src/resources/skills/mandu-styling/rules/style-component-tokens.md +205 -205
- package/src/resources/skills/mandu-styling/rules/style-island-animations.md +272 -272
- package/src/resources/skills/mandu-styling/rules/style-island-scoping.md +167 -167
- package/src/resources/skills/mandu-styling/rules/style-island-variants.md +221 -221
- package/src/resources/skills/mandu-styling/rules/style-perf-critical.md +209 -209
- package/src/resources/skills/mandu-styling/rules/style-perf-purge.md +192 -192
- package/src/resources/skills/mandu-styling/rules/style-setup-modules.md +162 -162
- package/src/resources/skills/mandu-styling/rules/style-setup-panda.md +164 -164
- package/src/resources/skills/mandu-styling/rules/style-setup-tailwind.md +170 -170
- package/src/resources/skills/mandu-styling/rules/style-tailwind-v4-gotchas.md +179 -179
- package/src/resources/skills/mandu-styling/rules/style-theme-darkmode.md +229 -229
- package/src/resources/skills/mandu-testing/SKILL.md +99 -99
- package/src/resources/skills/mandu-testing/metadata.json +13 -13
- package/src/resources/skills/mandu-testing/rules/_sections.md +26 -26
- package/src/resources/skills/mandu-testing/rules/_template.md +65 -65
- package/src/resources/skills/mandu-testing/rules/test-component-island.md +195 -195
- package/src/resources/skills/mandu-testing/rules/test-e2e-playwright.md +196 -196
- package/src/resources/skills/mandu-testing/rules/test-mock-fetch.md +219 -219
- package/src/resources/skills/mandu-testing/rules/test-slot-unit.md +192 -192
- package/src/resources/skills/mandu-ui/SKILL.md +117 -117
- package/src/resources/skills/mandu-ui/_sections.md +23 -23
- package/src/resources/skills/mandu-ui/_template.md +32 -32
- package/src/resources/skills/mandu-ui/metadata.json +13 -13
- package/src/resources/skills/mandu-ui/rules/ui-accessibility-aria.md +232 -232
- package/src/resources/skills/mandu-ui/rules/ui-accessibility-focus.md +238 -238
- package/src/resources/skills/mandu-ui/rules/ui-composition-patterns.md +259 -259
- package/src/resources/skills/mandu-ui/rules/ui-island-integration.md +258 -258
- package/src/resources/skills/mandu-ui/rules/ui-radix-patterns.md +213 -213
- package/src/resources/skills/mandu-ui/rules/ui-shadcn-setup.md +209 -209
- package/src/resources/skills/recipes.ts +932 -932
- package/src/tools/generate.ts +7 -4
- package/src/tools/guard.ts +17 -4
- package/src/tools/hydration.ts +10 -10
- package/src/tools/project.ts +334 -334
- package/src/tools/runtime.ts +497 -497
- package/src/tools/seo.ts +417 -417
- package/src/tools/spec.ts +80 -159
- package/src/utils/project.ts +22 -12
- package/src/utils/withWarnings.ts +83 -83
package/src/adapters/index.ts
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* MCP Adapters
|
|
3
|
-
*
|
|
4
|
-
* DNA 기능과 MCP 간의 변환 어댑터
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
export {
|
|
8
|
-
toolToPlugin,
|
|
9
|
-
pluginToTool,
|
|
10
|
-
moduleToPlugins,
|
|
11
|
-
pluginsToTools,
|
|
12
|
-
pluginsToHandlers,
|
|
13
|
-
} from "./tool-adapter.js";
|
|
14
|
-
|
|
15
|
-
export {
|
|
16
|
-
monitorEventToRecord,
|
|
17
|
-
recordToMonitorEvent,
|
|
18
|
-
severityToLevel,
|
|
19
|
-
levelToSeverity,
|
|
20
|
-
} from "./monitor-adapter.js";
|
|
1
|
+
/**
|
|
2
|
+
* MCP Adapters
|
|
3
|
+
*
|
|
4
|
+
* DNA 기능과 MCP 간의 변환 어댑터
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
export {
|
|
8
|
+
toolToPlugin,
|
|
9
|
+
pluginToTool,
|
|
10
|
+
moduleToPlugins,
|
|
11
|
+
pluginsToTools,
|
|
12
|
+
pluginsToHandlers,
|
|
13
|
+
} from "./tool-adapter.js";
|
|
14
|
+
|
|
15
|
+
export {
|
|
16
|
+
monitorEventToRecord,
|
|
17
|
+
recordToMonitorEvent,
|
|
18
|
+
severityToLevel,
|
|
19
|
+
levelToSeverity,
|
|
20
|
+
} from "./monitor-adapter.js";
|
|
@@ -1,100 +1,100 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Monitor Event Adapter
|
|
3
|
-
*
|
|
4
|
-
* ActivityMonitor 이벤트와 DNA-008 LogTransportRecord 간 변환
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
import type { LogTransportRecord } from "@mandujs/core";
|
|
8
|
-
|
|
9
|
-
/**
|
|
10
|
-
* Monitor 이벤트 타입 (ActivityMonitor에서 사용)
|
|
11
|
-
*/
|
|
12
|
-
export interface MonitorEvent {
|
|
13
|
-
ts: string;
|
|
14
|
-
type: string;
|
|
15
|
-
severity: MonitorSeverity;
|
|
16
|
-
source: string;
|
|
17
|
-
message?: string;
|
|
18
|
-
data?: Record<string, unknown>;
|
|
19
|
-
actionRequired?: boolean;
|
|
20
|
-
fingerprint?: string;
|
|
21
|
-
count?: number;
|
|
22
|
-
schemaVersion?: string;
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
export type MonitorSeverity = "info" | "warn" | "error";
|
|
26
|
-
export type LogLevel = "debug" | "info" | "warn" | "error";
|
|
27
|
-
|
|
28
|
-
/**
|
|
29
|
-
* MonitorSeverity → LogLevel 변환
|
|
30
|
-
*/
|
|
31
|
-
export function severityToLevel(severity: MonitorSeverity): LogLevel {
|
|
32
|
-
switch (severity) {
|
|
33
|
-
case "error":
|
|
34
|
-
return "error";
|
|
35
|
-
case "warn":
|
|
36
|
-
return "warn";
|
|
37
|
-
case "info":
|
|
38
|
-
default:
|
|
39
|
-
return "info";
|
|
40
|
-
}
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
/**
|
|
44
|
-
* LogLevel → MonitorSeverity 변환
|
|
45
|
-
*/
|
|
46
|
-
export function levelToSeverity(level: LogLevel): MonitorSeverity {
|
|
47
|
-
switch (level) {
|
|
48
|
-
case "error":
|
|
49
|
-
return "error";
|
|
50
|
-
case "warn":
|
|
51
|
-
return "warn";
|
|
52
|
-
case "debug":
|
|
53
|
-
case "info":
|
|
54
|
-
default:
|
|
55
|
-
return "info";
|
|
56
|
-
}
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
/**
|
|
60
|
-
* MonitorEvent → LogTransportRecord 변환
|
|
61
|
-
*
|
|
62
|
-
* ActivityMonitor 이벤트를 DNA-008 로깅 시스템으로 전송할 때 사용
|
|
63
|
-
*/
|
|
64
|
-
export function monitorEventToRecord(event: MonitorEvent): LogTransportRecord {
|
|
65
|
-
return {
|
|
66
|
-
timestamp: event.ts,
|
|
67
|
-
level: severityToLevel(event.severity),
|
|
68
|
-
meta: {
|
|
69
|
-
type: event.type,
|
|
70
|
-
source: event.source,
|
|
71
|
-
fingerprint: event.fingerprint,
|
|
72
|
-
count: event.count,
|
|
73
|
-
actionRequired: event.actionRequired,
|
|
74
|
-
schemaVersion: event.schemaVersion,
|
|
75
|
-
...event.data,
|
|
76
|
-
},
|
|
77
|
-
};
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
/**
|
|
81
|
-
* LogTransportRecord → MonitorEvent 변환 (역방향)
|
|
82
|
-
*
|
|
83
|
-
* DNA-008 로그를 ActivityMonitor에서 표시할 때 사용
|
|
84
|
-
*/
|
|
85
|
-
export function recordToMonitorEvent(record: LogTransportRecord): MonitorEvent {
|
|
86
|
-
const meta = record.meta ?? {};
|
|
87
|
-
|
|
88
|
-
return {
|
|
89
|
-
ts: record.timestamp,
|
|
90
|
-
type: (meta.type as string) ?? "log",
|
|
91
|
-
severity: levelToSeverity(record.level),
|
|
92
|
-
source: (meta.source as string) ?? "unknown",
|
|
93
|
-
message: record.error?.message,
|
|
94
|
-
data: meta,
|
|
95
|
-
actionRequired: (meta.actionRequired as boolean) ?? false,
|
|
96
|
-
fingerprint: meta.fingerprint as string | undefined,
|
|
97
|
-
count: meta.count as number | undefined,
|
|
98
|
-
schemaVersion: meta.schemaVersion as string | undefined,
|
|
99
|
-
};
|
|
100
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Monitor Event Adapter
|
|
3
|
+
*
|
|
4
|
+
* ActivityMonitor 이벤트와 DNA-008 LogTransportRecord 간 변환
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import type { LogTransportRecord } from "@mandujs/core";
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Monitor 이벤트 타입 (ActivityMonitor에서 사용)
|
|
11
|
+
*/
|
|
12
|
+
export interface MonitorEvent {
|
|
13
|
+
ts: string;
|
|
14
|
+
type: string;
|
|
15
|
+
severity: MonitorSeverity;
|
|
16
|
+
source: string;
|
|
17
|
+
message?: string;
|
|
18
|
+
data?: Record<string, unknown>;
|
|
19
|
+
actionRequired?: boolean;
|
|
20
|
+
fingerprint?: string;
|
|
21
|
+
count?: number;
|
|
22
|
+
schemaVersion?: string;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
export type MonitorSeverity = "info" | "warn" | "error";
|
|
26
|
+
export type LogLevel = "debug" | "info" | "warn" | "error";
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* MonitorSeverity → LogLevel 변환
|
|
30
|
+
*/
|
|
31
|
+
export function severityToLevel(severity: MonitorSeverity): LogLevel {
|
|
32
|
+
switch (severity) {
|
|
33
|
+
case "error":
|
|
34
|
+
return "error";
|
|
35
|
+
case "warn":
|
|
36
|
+
return "warn";
|
|
37
|
+
case "info":
|
|
38
|
+
default:
|
|
39
|
+
return "info";
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* LogLevel → MonitorSeverity 변환
|
|
45
|
+
*/
|
|
46
|
+
export function levelToSeverity(level: LogLevel): MonitorSeverity {
|
|
47
|
+
switch (level) {
|
|
48
|
+
case "error":
|
|
49
|
+
return "error";
|
|
50
|
+
case "warn":
|
|
51
|
+
return "warn";
|
|
52
|
+
case "debug":
|
|
53
|
+
case "info":
|
|
54
|
+
default:
|
|
55
|
+
return "info";
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* MonitorEvent → LogTransportRecord 변환
|
|
61
|
+
*
|
|
62
|
+
* ActivityMonitor 이벤트를 DNA-008 로깅 시스템으로 전송할 때 사용
|
|
63
|
+
*/
|
|
64
|
+
export function monitorEventToRecord(event: MonitorEvent): LogTransportRecord {
|
|
65
|
+
return {
|
|
66
|
+
timestamp: event.ts,
|
|
67
|
+
level: severityToLevel(event.severity),
|
|
68
|
+
meta: {
|
|
69
|
+
type: event.type,
|
|
70
|
+
source: event.source,
|
|
71
|
+
fingerprint: event.fingerprint,
|
|
72
|
+
count: event.count,
|
|
73
|
+
actionRequired: event.actionRequired,
|
|
74
|
+
schemaVersion: event.schemaVersion,
|
|
75
|
+
...event.data,
|
|
76
|
+
},
|
|
77
|
+
};
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
/**
|
|
81
|
+
* LogTransportRecord → MonitorEvent 변환 (역방향)
|
|
82
|
+
*
|
|
83
|
+
* DNA-008 로그를 ActivityMonitor에서 표시할 때 사용
|
|
84
|
+
*/
|
|
85
|
+
export function recordToMonitorEvent(record: LogTransportRecord): MonitorEvent {
|
|
86
|
+
const meta = record.meta ?? {};
|
|
87
|
+
|
|
88
|
+
return {
|
|
89
|
+
ts: record.timestamp,
|
|
90
|
+
type: (meta.type as string) ?? "log",
|
|
91
|
+
severity: levelToSeverity(record.level),
|
|
92
|
+
source: (meta.source as string) ?? "unknown",
|
|
93
|
+
message: record.error?.message,
|
|
94
|
+
data: meta,
|
|
95
|
+
actionRequired: (meta.actionRequired as boolean) ?? false,
|
|
96
|
+
fingerprint: meta.fingerprint as string | undefined,
|
|
97
|
+
count: meta.count as number | undefined,
|
|
98
|
+
schemaVersion: meta.schemaVersion as string | undefined,
|
|
99
|
+
};
|
|
100
|
+
}
|
|
@@ -1,88 +1,88 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* MCP Tool Adapter
|
|
3
|
-
*
|
|
4
|
-
* MCP SDK Tool을 DNA-001 McpToolPlugin으로 변환
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
import type { Tool } from "@modelcontextprotocol/sdk/types.js";
|
|
8
|
-
import type { McpToolPlugin } from "@mandujs/core";
|
|
9
|
-
|
|
10
|
-
/**
|
|
11
|
-
* MCP SDK Tool을 McpToolPlugin으로 변환
|
|
12
|
-
*
|
|
13
|
-
* @example
|
|
14
|
-
* ```ts
|
|
15
|
-
* const plugin = toolToPlugin(
|
|
16
|
-
* { name: "my_tool", description: "...", inputSchema: {} },
|
|
17
|
-
* async (args) => ({ success: true })
|
|
18
|
-
* );
|
|
19
|
-
* ```
|
|
20
|
-
*/
|
|
21
|
-
export function toolToPlugin(
|
|
22
|
-
definition: Tool,
|
|
23
|
-
handler: (args: Record<string, unknown>) => Promise<unknown>
|
|
24
|
-
): McpToolPlugin {
|
|
25
|
-
return {
|
|
26
|
-
name: definition.name,
|
|
27
|
-
description: definition.description ?? "",
|
|
28
|
-
inputSchema: definition.inputSchema as Record<string, unknown>,
|
|
29
|
-
execute: handler,
|
|
30
|
-
};
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
/**
|
|
34
|
-
* McpToolPlugin을 MCP SDK Tool로 변환 (역방향)
|
|
35
|
-
*/
|
|
36
|
-
export function pluginToTool(plugin: McpToolPlugin): Tool {
|
|
37
|
-
return {
|
|
38
|
-
name: plugin.name,
|
|
39
|
-
description: plugin.description,
|
|
40
|
-
inputSchema: plugin.inputSchema,
|
|
41
|
-
};
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
/**
|
|
45
|
-
* 기존 도구 모듈(definitions + handlers)을 플러그인 배열로 변환
|
|
46
|
-
*
|
|
47
|
-
* @example
|
|
48
|
-
* ```ts
|
|
49
|
-
* const plugins = moduleToPlugins(
|
|
50
|
-
* specToolDefinitions,
|
|
51
|
-
* specTools(projectRoot)
|
|
52
|
-
* );
|
|
53
|
-
* ```
|
|
54
|
-
*/
|
|
55
|
-
export function moduleToPlugins(
|
|
56
|
-
definitions: Tool[],
|
|
57
|
-
handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>>
|
|
58
|
-
): McpToolPlugin[] {
|
|
59
|
-
return definitions.map((def) => {
|
|
60
|
-
const handler = handlers[def.name];
|
|
61
|
-
if (!handler) {
|
|
62
|
-
throw new Error(`Handler not found for tool: ${def.name}`);
|
|
63
|
-
}
|
|
64
|
-
return toolToPlugin(def, handler);
|
|
65
|
-
});
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
/**
|
|
69
|
-
* 플러그인 배열을 MCP SDK Tool 배열로 변환
|
|
70
|
-
*/
|
|
71
|
-
export function pluginsToTools(plugins: McpToolPlugin[]): Tool[] {
|
|
72
|
-
return plugins.map(pluginToTool);
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
/**
|
|
76
|
-
* 플러그인 배열을 핸들러 맵으로 변환
|
|
77
|
-
*/
|
|
78
|
-
export function pluginsToHandlers(
|
|
79
|
-
plugins: McpToolPlugin[]
|
|
80
|
-
): Record<string, (args: Record<string, unknown>) => Promise<unknown>> {
|
|
81
|
-
const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {};
|
|
82
|
-
|
|
83
|
-
for (const plugin of plugins) {
|
|
84
|
-
handlers[plugin.name] = async (args) => plugin.execute(args);
|
|
85
|
-
}
|
|
86
|
-
|
|
87
|
-
return handlers;
|
|
88
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* MCP Tool Adapter
|
|
3
|
+
*
|
|
4
|
+
* MCP SDK Tool을 DNA-001 McpToolPlugin으로 변환
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import type { Tool } from "@modelcontextprotocol/sdk/types.js";
|
|
8
|
+
import type { McpToolPlugin } from "@mandujs/core";
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* MCP SDK Tool을 McpToolPlugin으로 변환
|
|
12
|
+
*
|
|
13
|
+
* @example
|
|
14
|
+
* ```ts
|
|
15
|
+
* const plugin = toolToPlugin(
|
|
16
|
+
* { name: "my_tool", description: "...", inputSchema: {} },
|
|
17
|
+
* async (args) => ({ success: true })
|
|
18
|
+
* );
|
|
19
|
+
* ```
|
|
20
|
+
*/
|
|
21
|
+
export function toolToPlugin(
|
|
22
|
+
definition: Tool,
|
|
23
|
+
handler: (args: Record<string, unknown>) => Promise<unknown>
|
|
24
|
+
): McpToolPlugin {
|
|
25
|
+
return {
|
|
26
|
+
name: definition.name,
|
|
27
|
+
description: definition.description ?? "",
|
|
28
|
+
inputSchema: definition.inputSchema as Record<string, unknown>,
|
|
29
|
+
execute: handler,
|
|
30
|
+
};
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* McpToolPlugin을 MCP SDK Tool로 변환 (역방향)
|
|
35
|
+
*/
|
|
36
|
+
export function pluginToTool(plugin: McpToolPlugin): Tool {
|
|
37
|
+
return {
|
|
38
|
+
name: plugin.name,
|
|
39
|
+
description: plugin.description,
|
|
40
|
+
inputSchema: plugin.inputSchema,
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* 기존 도구 모듈(definitions + handlers)을 플러그인 배열로 변환
|
|
46
|
+
*
|
|
47
|
+
* @example
|
|
48
|
+
* ```ts
|
|
49
|
+
* const plugins = moduleToPlugins(
|
|
50
|
+
* specToolDefinitions,
|
|
51
|
+
* specTools(projectRoot)
|
|
52
|
+
* );
|
|
53
|
+
* ```
|
|
54
|
+
*/
|
|
55
|
+
export function moduleToPlugins(
|
|
56
|
+
definitions: Tool[],
|
|
57
|
+
handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>>
|
|
58
|
+
): McpToolPlugin[] {
|
|
59
|
+
return definitions.map((def) => {
|
|
60
|
+
const handler = handlers[def.name];
|
|
61
|
+
if (!handler) {
|
|
62
|
+
throw new Error(`Handler not found for tool: ${def.name}`);
|
|
63
|
+
}
|
|
64
|
+
return toolToPlugin(def, handler);
|
|
65
|
+
});
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* 플러그인 배열을 MCP SDK Tool 배열로 변환
|
|
70
|
+
*/
|
|
71
|
+
export function pluginsToTools(plugins: McpToolPlugin[]): Tool[] {
|
|
72
|
+
return plugins.map(pluginToTool);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* 플러그인 배열을 핸들러 맵으로 변환
|
|
77
|
+
*/
|
|
78
|
+
export function pluginsToHandlers(
|
|
79
|
+
plugins: McpToolPlugin[]
|
|
80
|
+
): Record<string, (args: Record<string, unknown>) => Promise<unknown>> {
|
|
81
|
+
const handlers: Record<string, (args: Record<string, unknown>) => Promise<unknown>> = {};
|
|
82
|
+
|
|
83
|
+
for (const plugin of plugins) {
|
|
84
|
+
handlers[plugin.name] = async (args) => plugin.execute(args);
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
return handlers;
|
|
88
|
+
}
|