learngraph 0.5.0 → 0.7.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.
Files changed (235) hide show
  1. package/dist/cjs/api/routes/analytics.js +288 -0
  2. package/dist/cjs/api/routes/analytics.js.map +1 -0
  3. package/dist/cjs/api/routes/assessments.js +269 -0
  4. package/dist/cjs/api/routes/assessments.js.map +1 -0
  5. package/dist/cjs/api/routes/curriculum.js +345 -0
  6. package/dist/cjs/api/routes/curriculum.js.map +1 -0
  7. package/dist/cjs/api/routes/edges.js +162 -0
  8. package/dist/cjs/api/routes/edges.js.map +1 -0
  9. package/dist/cjs/api/routes/explore.js +224 -0
  10. package/dist/cjs/api/routes/explore.js.map +1 -0
  11. package/dist/cjs/api/routes/learners.js +324 -0
  12. package/dist/cjs/api/routes/learners.js.map +1 -0
  13. package/dist/cjs/api/routes/me.js +404 -0
  14. package/dist/cjs/api/routes/me.js.map +1 -0
  15. package/dist/cjs/api/routes/skills.js +319 -0
  16. package/dist/cjs/api/routes/skills.js.map +1 -0
  17. package/dist/cjs/api/server.js +185 -0
  18. package/dist/cjs/api/server.js.map +1 -0
  19. package/dist/cjs/api/types.js +10 -0
  20. package/dist/cjs/api/types.js.map +1 -0
  21. package/dist/cjs/assessment/adaptive.js +390 -0
  22. package/dist/cjs/assessment/adaptive.js.map +1 -0
  23. package/dist/cjs/assessment/bkt.js +362 -0
  24. package/dist/cjs/assessment/bkt.js.map +1 -0
  25. package/dist/cjs/assessment/index.js +54 -0
  26. package/dist/cjs/assessment/index.js.map +1 -0
  27. package/dist/cjs/assessment/irt.js +420 -0
  28. package/dist/cjs/assessment/irt.js.map +1 -0
  29. package/dist/cjs/assessment/mastery-engine.js +411 -0
  30. package/dist/cjs/assessment/mastery-engine.js.map +1 -0
  31. package/dist/cjs/components/LearningPathView.js +320 -0
  32. package/dist/cjs/components/LearningPathView.js.map +1 -0
  33. package/dist/cjs/components/ProgressDashboard.js +308 -0
  34. package/dist/cjs/components/ProgressDashboard.js.map +1 -0
  35. package/dist/cjs/components/SkillCard.js +264 -0
  36. package/dist/cjs/components/SkillCard.js.map +1 -0
  37. package/dist/cjs/components/SkillExplorer.js +401 -0
  38. package/dist/cjs/components/SkillExplorer.js.map +1 -0
  39. package/dist/cjs/components/SkillGraph.js +435 -0
  40. package/dist/cjs/components/SkillGraph.js.map +1 -0
  41. package/dist/cjs/components/hooks.js +510 -0
  42. package/dist/cjs/components/hooks.js.map +1 -0
  43. package/dist/cjs/components/index.js +77 -0
  44. package/dist/cjs/components/index.js.map +1 -0
  45. package/dist/cjs/components/types.js +34 -0
  46. package/dist/cjs/components/types.js.map +1 -0
  47. package/dist/cjs/index.js +35 -1
  48. package/dist/cjs/index.js.map +1 -1
  49. package/dist/cjs/llm/adapters/anthropic.js +91 -3
  50. package/dist/cjs/llm/adapters/anthropic.js.map +1 -1
  51. package/dist/cjs/llm/adapters/gemini.js +101 -8
  52. package/dist/cjs/llm/adapters/gemini.js.map +1 -1
  53. package/dist/cjs/llm/adapters/index.js +42 -1
  54. package/dist/cjs/llm/adapters/index.js.map +1 -1
  55. package/dist/cjs/llm/adapters/ollama.js +120 -3
  56. package/dist/cjs/llm/adapters/ollama.js.map +1 -1
  57. package/dist/cjs/llm/adapters/openai.js +108 -2
  58. package/dist/cjs/llm/adapters/openai.js.map +1 -1
  59. package/dist/cjs/mcp/cli.js +302 -0
  60. package/dist/cjs/mcp/cli.js.map +1 -0
  61. package/dist/cjs/mcp/index.js +79 -0
  62. package/dist/cjs/mcp/index.js.map +1 -0
  63. package/dist/cjs/mcp/prompts.js +425 -0
  64. package/dist/cjs/mcp/prompts.js.map +1 -0
  65. package/dist/cjs/mcp/resources.js +371 -0
  66. package/dist/cjs/mcp/resources.js.map +1 -0
  67. package/dist/cjs/mcp/server.js +410 -0
  68. package/dist/cjs/mcp/server.js.map +1 -0
  69. package/dist/cjs/mcp/tools.js +612 -0
  70. package/dist/cjs/mcp/tools.js.map +1 -0
  71. package/dist/cjs/mcp/types.js +10 -0
  72. package/dist/cjs/mcp/types.js.map +1 -0
  73. package/dist/cjs/types/assessment.js +46 -0
  74. package/dist/cjs/types/assessment.js.map +1 -0
  75. package/dist/cjs/types/bloom.js +12 -1
  76. package/dist/cjs/types/bloom.js.map +1 -1
  77. package/dist/cjs/types/index.js +7 -1
  78. package/dist/cjs/types/index.js.map +1 -1
  79. package/dist/esm/api/routes/analytics.js +285 -0
  80. package/dist/esm/api/routes/analytics.js.map +1 -0
  81. package/dist/esm/api/routes/assessments.js +266 -0
  82. package/dist/esm/api/routes/assessments.js.map +1 -0
  83. package/dist/esm/api/routes/curriculum.js +342 -0
  84. package/dist/esm/api/routes/curriculum.js.map +1 -0
  85. package/dist/esm/api/routes/edges.js +159 -0
  86. package/dist/esm/api/routes/edges.js.map +1 -0
  87. package/dist/esm/api/routes/explore.js +221 -0
  88. package/dist/esm/api/routes/explore.js.map +1 -0
  89. package/dist/esm/api/routes/learners.js +321 -0
  90. package/dist/esm/api/routes/learners.js.map +1 -0
  91. package/dist/esm/api/routes/me.js +401 -0
  92. package/dist/esm/api/routes/me.js.map +1 -0
  93. package/dist/esm/api/routes/skills.js +316 -0
  94. package/dist/esm/api/routes/skills.js.map +1 -0
  95. package/dist/esm/api/server.js +179 -0
  96. package/dist/esm/api/server.js.map +1 -0
  97. package/dist/esm/api/types.js +9 -0
  98. package/dist/esm/api/types.js.map +1 -0
  99. package/dist/esm/assessment/adaptive.js +384 -0
  100. package/dist/esm/assessment/adaptive.js.map +1 -0
  101. package/dist/esm/assessment/bkt.js +354 -0
  102. package/dist/esm/assessment/bkt.js.map +1 -0
  103. package/dist/esm/assessment/index.js +21 -0
  104. package/dist/esm/assessment/index.js.map +1 -0
  105. package/dist/esm/assessment/irt.js +406 -0
  106. package/dist/esm/assessment/irt.js.map +1 -0
  107. package/dist/esm/assessment/mastery-engine.js +406 -0
  108. package/dist/esm/assessment/mastery-engine.js.map +1 -0
  109. package/dist/esm/components/LearningPathView.js +316 -0
  110. package/dist/esm/components/LearningPathView.js.map +1 -0
  111. package/dist/esm/components/ProgressDashboard.js +304 -0
  112. package/dist/esm/components/ProgressDashboard.js.map +1 -0
  113. package/dist/esm/components/SkillCard.js +260 -0
  114. package/dist/esm/components/SkillCard.js.map +1 -0
  115. package/dist/esm/components/SkillExplorer.js +397 -0
  116. package/dist/esm/components/SkillExplorer.js.map +1 -0
  117. package/dist/esm/components/SkillGraph.js +398 -0
  118. package/dist/esm/components/SkillGraph.js.map +1 -0
  119. package/dist/esm/components/hooks.js +502 -0
  120. package/dist/esm/components/hooks.js.map +1 -0
  121. package/dist/esm/components/index.js +61 -0
  122. package/dist/esm/components/index.js.map +1 -0
  123. package/dist/esm/components/types.js +31 -0
  124. package/dist/esm/components/types.js.map +1 -0
  125. package/dist/esm/index.js +12 -0
  126. package/dist/esm/index.js.map +1 -1
  127. package/dist/esm/llm/adapters/anthropic.js +88 -2
  128. package/dist/esm/llm/adapters/anthropic.js.map +1 -1
  129. package/dist/esm/llm/adapters/gemini.js +98 -7
  130. package/dist/esm/llm/adapters/gemini.js.map +1 -1
  131. package/dist/esm/llm/adapters/index.js +15 -4
  132. package/dist/esm/llm/adapters/index.js.map +1 -1
  133. package/dist/esm/llm/adapters/ollama.js +117 -2
  134. package/dist/esm/llm/adapters/ollama.js.map +1 -1
  135. package/dist/esm/llm/adapters/openai.js +105 -1
  136. package/dist/esm/llm/adapters/openai.js.map +1 -1
  137. package/dist/esm/mcp/cli.js +267 -0
  138. package/dist/esm/mcp/cli.js.map +1 -0
  139. package/dist/esm/mcp/index.js +39 -0
  140. package/dist/esm/mcp/index.js.map +1 -0
  141. package/dist/esm/mcp/prompts.js +419 -0
  142. package/dist/esm/mcp/prompts.js.map +1 -0
  143. package/dist/esm/mcp/resources.js +359 -0
  144. package/dist/esm/mcp/resources.js.map +1 -0
  145. package/dist/esm/mcp/server.js +372 -0
  146. package/dist/esm/mcp/server.js.map +1 -0
  147. package/dist/esm/mcp/tools.js +598 -0
  148. package/dist/esm/mcp/tools.js.map +1 -0
  149. package/dist/esm/mcp/types.js +9 -0
  150. package/dist/esm/mcp/types.js.map +1 -0
  151. package/dist/esm/types/assessment.js +40 -0
  152. package/dist/esm/types/assessment.js.map +1 -0
  153. package/dist/esm/types/bloom.js +11 -0
  154. package/dist/esm/types/bloom.js.map +1 -1
  155. package/dist/esm/types/index.js +2 -1
  156. package/dist/esm/types/index.js.map +1 -1
  157. package/dist/types/api/routes/analytics.d.ts +14 -0
  158. package/dist/types/api/routes/analytics.d.ts.map +1 -0
  159. package/dist/types/api/routes/assessments.d.ts +14 -0
  160. package/dist/types/api/routes/assessments.d.ts.map +1 -0
  161. package/dist/types/api/routes/curriculum.d.ts +14 -0
  162. package/dist/types/api/routes/curriculum.d.ts.map +1 -0
  163. package/dist/types/api/routes/edges.d.ts +14 -0
  164. package/dist/types/api/routes/edges.d.ts.map +1 -0
  165. package/dist/types/api/routes/explore.d.ts +14 -0
  166. package/dist/types/api/routes/explore.d.ts.map +1 -0
  167. package/dist/types/api/routes/learners.d.ts +14 -0
  168. package/dist/types/api/routes/learners.d.ts.map +1 -0
  169. package/dist/types/api/routes/me.d.ts +14 -0
  170. package/dist/types/api/routes/me.d.ts.map +1 -0
  171. package/dist/types/api/routes/skills.d.ts +14 -0
  172. package/dist/types/api/routes/skills.d.ts.map +1 -0
  173. package/dist/types/api/server.d.ts +147 -0
  174. package/dist/types/api/server.d.ts.map +1 -0
  175. package/dist/types/api/types.d.ts +443 -0
  176. package/dist/types/api/types.d.ts.map +1 -0
  177. package/dist/types/assessment/adaptive.d.ts +155 -0
  178. package/dist/types/assessment/adaptive.d.ts.map +1 -0
  179. package/dist/types/assessment/bkt.d.ts +185 -0
  180. package/dist/types/assessment/bkt.d.ts.map +1 -0
  181. package/dist/types/assessment/index.d.ts +18 -0
  182. package/dist/types/assessment/index.d.ts.map +1 -0
  183. package/dist/types/assessment/irt.d.ts +159 -0
  184. package/dist/types/assessment/irt.d.ts.map +1 -0
  185. package/dist/types/assessment/mastery-engine.d.ts +178 -0
  186. package/dist/types/assessment/mastery-engine.d.ts.map +1 -0
  187. package/dist/types/components/LearningPathView.d.ts +40 -0
  188. package/dist/types/components/LearningPathView.d.ts.map +1 -0
  189. package/dist/types/components/ProgressDashboard.d.ts +49 -0
  190. package/dist/types/components/ProgressDashboard.d.ts.map +1 -0
  191. package/dist/types/components/SkillCard.d.ts +34 -0
  192. package/dist/types/components/SkillCard.d.ts.map +1 -0
  193. package/dist/types/components/SkillExplorer.d.ts +39 -0
  194. package/dist/types/components/SkillExplorer.d.ts.map +1 -0
  195. package/dist/types/components/SkillGraph.d.ts +38 -0
  196. package/dist/types/components/SkillGraph.d.ts.map +1 -0
  197. package/dist/types/components/hooks.d.ts +187 -0
  198. package/dist/types/components/hooks.d.ts.map +1 -0
  199. package/dist/types/components/index.d.ts +59 -0
  200. package/dist/types/components/index.d.ts.map +1 -0
  201. package/dist/types/components/types.d.ts +410 -0
  202. package/dist/types/components/types.d.ts.map +1 -0
  203. package/dist/types/index.d.ts +1 -0
  204. package/dist/types/index.d.ts.map +1 -1
  205. package/dist/types/llm/adapters/anthropic.d.ts +84 -1
  206. package/dist/types/llm/adapters/anthropic.d.ts.map +1 -1
  207. package/dist/types/llm/adapters/gemini.d.ts +93 -6
  208. package/dist/types/llm/adapters/gemini.d.ts.map +1 -1
  209. package/dist/types/llm/adapters/index.d.ts +13 -4
  210. package/dist/types/llm/adapters/index.d.ts.map +1 -1
  211. package/dist/types/llm/adapters/ollama.d.ts +126 -1
  212. package/dist/types/llm/adapters/ollama.d.ts.map +1 -1
  213. package/dist/types/llm/adapters/openai.d.ts +104 -1
  214. package/dist/types/llm/adapters/openai.d.ts.map +1 -1
  215. package/dist/types/mcp/cli.d.ts +15 -0
  216. package/dist/types/mcp/cli.d.ts.map +1 -0
  217. package/dist/types/mcp/index.d.ts +32 -0
  218. package/dist/types/mcp/index.d.ts.map +1 -0
  219. package/dist/types/mcp/prompts.d.ts +27 -0
  220. package/dist/types/mcp/prompts.d.ts.map +1 -0
  221. package/dist/types/mcp/resources.d.ts +59 -0
  222. package/dist/types/mcp/resources.d.ts.map +1 -0
  223. package/dist/types/mcp/server.d.ts +136 -0
  224. package/dist/types/mcp/server.d.ts.map +1 -0
  225. package/dist/types/mcp/tools.d.ts +344 -0
  226. package/dist/types/mcp/tools.d.ts.map +1 -0
  227. package/dist/types/mcp/types.d.ts +137 -0
  228. package/dist/types/mcp/types.d.ts.map +1 -0
  229. package/dist/types/types/assessment.d.ts +512 -0
  230. package/dist/types/types/assessment.d.ts.map +1 -0
  231. package/dist/types/types/bloom.d.ts +4 -0
  232. package/dist/types/types/bloom.d.ts.map +1 -1
  233. package/dist/types/types/index.d.ts +3 -1
  234. package/dist/types/types/index.d.ts.map +1 -1
  235. package/package.json +48 -3
@@ -0,0 +1,372 @@
1
+ /**
2
+ * LearnGraph MCP Server
3
+ *
4
+ * Model Context Protocol server for Claude integration.
5
+ * Exposes knowledge graph tools, resources, and prompts.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+ import { TOOL_DEFINITIONS, } from './tools.js';
10
+ import { listResources, resolveResource, getResourceTemplates, } from './resources.js';
11
+ import { getPromptMetas, renderPrompt, getPromptDefinition, } from './prompts.js';
12
+ // ─────────────────────────────────────────────────────────────────────────────
13
+ // Server Implementation
14
+ // ─────────────────────────────────────────────────────────────────────────────
15
+ /**
16
+ * LearnGraph MCP Server
17
+ *
18
+ * Provides tools, resources, and prompts for Claude to interact with
19
+ * educational knowledge graphs.
20
+ *
21
+ * @example
22
+ * ```typescript
23
+ * import { LearnGraphMcpServer } from 'learngraph/mcp';
24
+ * import { MemoryStorage } from 'learngraph/storage';
25
+ *
26
+ * const storage = new MemoryStorage();
27
+ * await storage.connect({ backend: 'memory' });
28
+ *
29
+ * const server = new LearnGraphMcpServer({ storage });
30
+ * await server.start();
31
+ * ```
32
+ */
33
+ export class LearnGraphMcpServer {
34
+ storage;
35
+ config;
36
+ isRunning = false;
37
+ constructor(config) {
38
+ this.storage = config.storage;
39
+ this.config = {
40
+ name: 'learngraph',
41
+ version: '0.5.0',
42
+ debug: false,
43
+ ...config,
44
+ };
45
+ }
46
+ /**
47
+ * Log debug messages
48
+ */
49
+ log(message, ...args) {
50
+ if (this.config.debug) {
51
+ // Use stderr for logging to not interfere with stdio transport
52
+ console.error(`[LearnGraph MCP] ${message}`, ...args);
53
+ }
54
+ }
55
+ /**
56
+ * Get server info
57
+ */
58
+ getServerInfo() {
59
+ return {
60
+ name: this.config.name,
61
+ version: this.config.version,
62
+ };
63
+ }
64
+ /**
65
+ * List available tools
66
+ */
67
+ listTools() {
68
+ return Object.entries(TOOL_DEFINITIONS).map(([name, def]) => ({
69
+ name,
70
+ description: def.description,
71
+ inputSchema: this.zodToJsonSchema(def.inputSchema),
72
+ }));
73
+ }
74
+ /**
75
+ * Execute a tool
76
+ */
77
+ async executeTool(name, args) {
78
+ const tool = TOOL_DEFINITIONS[name];
79
+ if (!tool) {
80
+ return {
81
+ content: [{
82
+ type: 'text',
83
+ text: JSON.stringify({ error: `Unknown tool: ${name}` }),
84
+ }],
85
+ isError: true,
86
+ };
87
+ }
88
+ try {
89
+ // Validate and parse input
90
+ const parsed = tool.inputSchema.parse(args);
91
+ // Execute tool handler
92
+ return await tool.handler(this.storage, parsed);
93
+ }
94
+ catch (err) {
95
+ this.log('Tool execution error:', err);
96
+ return {
97
+ content: [{
98
+ type: 'text',
99
+ text: JSON.stringify({
100
+ error: err instanceof Error ? err.message : 'Unknown error',
101
+ }),
102
+ }],
103
+ isError: true,
104
+ };
105
+ }
106
+ }
107
+ /**
108
+ * List available resources
109
+ */
110
+ async listResources() {
111
+ return listResources(this.storage);
112
+ }
113
+ /**
114
+ * Get resource templates
115
+ */
116
+ listResourceTemplates() {
117
+ return getResourceTemplates();
118
+ }
119
+ /**
120
+ * Read a resource
121
+ */
122
+ async readResource(uri) {
123
+ return resolveResource(this.storage, uri);
124
+ }
125
+ /**
126
+ * List available prompts
127
+ */
128
+ listPrompts() {
129
+ return getPromptMetas();
130
+ }
131
+ /**
132
+ * Get a prompt
133
+ */
134
+ getPrompt(name, args) {
135
+ const rendered = renderPrompt(name, args);
136
+ if (!rendered) {
137
+ return null;
138
+ }
139
+ const meta = getPromptDefinition(name);
140
+ const result = {
141
+ messages: [{
142
+ role: 'user',
143
+ content: rendered,
144
+ }],
145
+ };
146
+ if (meta?.description !== undefined) {
147
+ result.description = meta.description;
148
+ }
149
+ return result;
150
+ }
151
+ /**
152
+ * Convert Zod schema to JSON Schema
153
+ */
154
+ zodToJsonSchema(schema) {
155
+ // Simple conversion - in production would use zod-to-json-schema
156
+ const zodSchema = schema;
157
+ if (!zodSchema.shape) {
158
+ return { type: 'object', properties: {} };
159
+ }
160
+ const properties = {};
161
+ const required = [];
162
+ for (const [key, value] of Object.entries(zodSchema.shape)) {
163
+ const field = value;
164
+ const def = field._def;
165
+ let type = 'string';
166
+ let isOptional = false;
167
+ let description = def?.description;
168
+ let enumValues;
169
+ let items;
170
+ // Handle optional wrapper
171
+ if (def?.typeName === 'ZodOptional' || def?.typeName === 'ZodDefault') {
172
+ isOptional = true;
173
+ const inner = def.innerType;
174
+ if (inner?._def) {
175
+ if (inner._def.typeName === 'ZodNumber')
176
+ type = 'number';
177
+ else if (inner._def.typeName === 'ZodBoolean')
178
+ type = 'boolean';
179
+ else if (inner._def.typeName === 'ZodArray') {
180
+ type = 'array';
181
+ items = { type: 'string' };
182
+ }
183
+ else if (inner._def.typeName === 'ZodEnum') {
184
+ type = 'string';
185
+ enumValues = inner._def.values;
186
+ }
187
+ if (inner._def.description) {
188
+ description = inner._def.description;
189
+ }
190
+ }
191
+ }
192
+ else {
193
+ if (def?.typeName === 'ZodNumber')
194
+ type = 'number';
195
+ else if (def?.typeName === 'ZodBoolean')
196
+ type = 'boolean';
197
+ else if (def?.typeName === 'ZodArray') {
198
+ type = 'array';
199
+ items = { type: 'string' };
200
+ }
201
+ else if (def?.typeName === 'ZodEnum') {
202
+ type = 'string';
203
+ const enumDef = def;
204
+ enumValues = enumDef.values;
205
+ }
206
+ }
207
+ const propDef = { type };
208
+ if (description)
209
+ propDef.description = description;
210
+ if (enumValues)
211
+ propDef.enum = enumValues;
212
+ if (items)
213
+ propDef.items = items;
214
+ properties[key] = propDef;
215
+ if (!isOptional) {
216
+ required.push(key);
217
+ }
218
+ }
219
+ const result = {
220
+ type: 'object',
221
+ properties,
222
+ };
223
+ if (required.length > 0) {
224
+ result.required = required;
225
+ }
226
+ return result;
227
+ }
228
+ /**
229
+ * Start the MCP server (stdio transport)
230
+ *
231
+ * This requires @modelcontextprotocol/sdk to be installed.
232
+ */
233
+ async start() {
234
+ if (this.isRunning) {
235
+ throw new Error('Server is already running');
236
+ }
237
+ try {
238
+ // Dynamic import to avoid requiring MCP SDK as a hard dependency
239
+ const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
240
+ const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
241
+ const mcp = new McpServer({
242
+ name: this.config.name,
243
+ version: this.config.version,
244
+ });
245
+ // Register all tools using the new API
246
+ for (const [name, def] of Object.entries(TOOL_DEFINITIONS)) {
247
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
248
+ mcp.registerTool(name, {
249
+ description: def.description,
250
+ inputSchema: def.inputSchema,
251
+ }, async (args) => {
252
+ const result = await this.executeTool(name, args);
253
+ return {
254
+ content: result.content.map((c) => {
255
+ if (c.type === 'text') {
256
+ return { type: 'text', text: c.text };
257
+ }
258
+ // Handle image content if needed
259
+ return { type: 'text', text: '[Non-text content]' };
260
+ }),
261
+ isError: result.isError,
262
+ };
263
+ });
264
+ }
265
+ // Register resource template for dynamic resources
266
+ const { ResourceTemplate } = await import('@modelcontextprotocol/sdk/server/mcp.js');
267
+ // Register curriculum resources with wildcard pattern
268
+ mcp.registerResource('learngraph-curriculum', new ResourceTemplate('learngraph://curriculum/{path}', { list: undefined }), {
269
+ description: 'LearnGraph curriculum resources',
270
+ mimeType: 'application/json',
271
+ }, async (uri, _variables) => {
272
+ const fullUri = uri.href;
273
+ const resource = await this.readResource(fullUri);
274
+ if (!resource) {
275
+ return {
276
+ contents: [{
277
+ uri: fullUri,
278
+ mimeType: 'application/json',
279
+ text: JSON.stringify({ error: 'Resource not found' }),
280
+ }],
281
+ };
282
+ }
283
+ return {
284
+ contents: [{
285
+ uri: resource.uri,
286
+ mimeType: resource.mimeType,
287
+ text: resource.text ?? '',
288
+ }],
289
+ };
290
+ });
291
+ // Register prompts using the new API
292
+ for (const prompt of this.listPrompts()) {
293
+ // Build the args schema from the prompt arguments
294
+ const argsSchema = {};
295
+ const { z } = await import('zod');
296
+ for (const arg of prompt.arguments || []) {
297
+ if (arg.required) {
298
+ argsSchema[arg.name] = z.string().describe(arg.description || '');
299
+ }
300
+ else {
301
+ argsSchema[arg.name] = z.string().optional().describe(arg.description || '');
302
+ }
303
+ }
304
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
305
+ mcp.registerPrompt(prompt.name, {
306
+ description: prompt.description || '',
307
+ argsSchema,
308
+ }, (args) => {
309
+ // Convert undefined values to empty strings for the prompt
310
+ const cleanArgs = {};
311
+ for (const [key, value] of Object.entries(args)) {
312
+ cleanArgs[key] = value ?? '';
313
+ }
314
+ const result = this.getPrompt(prompt.name, cleanArgs);
315
+ if (!result) {
316
+ return {
317
+ messages: [{
318
+ role: 'user',
319
+ content: { type: 'text', text: 'Prompt not found' },
320
+ }],
321
+ };
322
+ }
323
+ return {
324
+ messages: result.messages.map((m) => ({
325
+ role: m.role,
326
+ content: { type: 'text', text: m.content },
327
+ })),
328
+ };
329
+ });
330
+ }
331
+ // Connect transport
332
+ const transport = new StdioServerTransport();
333
+ await mcp.connect(transport);
334
+ this.isRunning = true;
335
+ this.log('Server started');
336
+ }
337
+ catch (err) {
338
+ if (err instanceof Error && err.message.includes('Cannot find module')) {
339
+ throw new Error('MCP SDK not installed. Run: npm install @modelcontextprotocol/sdk');
340
+ }
341
+ throw err;
342
+ }
343
+ }
344
+ /**
345
+ * Check if server is running
346
+ */
347
+ get running() {
348
+ return this.isRunning;
349
+ }
350
+ }
351
+ /**
352
+ * Create and start an MCP server
353
+ *
354
+ * Convenience function for quick server setup.
355
+ *
356
+ * @example
357
+ * ```typescript
358
+ * import { startMcpServer } from 'learngraph/mcp';
359
+ * import { MemoryStorage } from 'learngraph/storage';
360
+ *
361
+ * const storage = new MemoryStorage();
362
+ * await storage.connect({ backend: 'memory' });
363
+ *
364
+ * await startMcpServer({ storage });
365
+ * ```
366
+ */
367
+ export async function startMcpServer(config) {
368
+ const server = new LearnGraphMcpServer(config);
369
+ await server.start();
370
+ return server;
371
+ }
372
+ //# sourceMappingURL=server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"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"}