@vue-skuilder/mcp 0.1.11-9 → 0.1.11

package/CLAUDE.md

@@ -16,15 +16,20 @@ Uses **tsup** for dual CommonJS/ESM output:
 - **ESM**: `dist/index.mjs` (primary)
 - **CommonJS**: `dist/index.js` (compatibility)
 - **Types**: `dist/index.d.ts`
+- **Target**: ES2022 with TypeScript ~5.7.2
+- **Source Maps**: Enabled for debugging
+- **Code Splitting**: Disabled for single-file output
 
 ## Dependencies
 - `@modelcontextprotocol/sdk` - MCP protocol implementation
 - `@vue-skuilder/db` - Database layer access
 - `@vue-skuilder/common` - Shared types and utilities
+- `@vue-skuilder/courseware` - DataShape definitions via `/backend` export
 - `zod` - Schema validation
 
 ## Dev Dependencies
 - `@modelcontextprotocol/inspector` - MCP server testing and debugging
+- `tsup` - TypeScript universal packager
 
 ## Architecture
 Course-scoped MCP servers that accept CourseDBInterface injection:

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { CourseDBInterface } from '@vue-skuilder/db';
-import { CourseConfig } from '@vue-skuilder/common';
+import { SkLogger, CourseConfig } from '@vue-skuilder/common';
 import { z } from 'zod';
 
 interface MCPServerOptions {
@@ -9,12 +9,14 @@ interface MCPServerOptions {
     maxCardsPerQuery?: number;
     allowedDataShapes?: string[];
     eloCalibrationMode?: 'strict' | 'adaptive' | 'manual';
+    logger?: SkLogger;
 }
 declare class MCPServer {
     private courseDB;
     private readonly options;
     private mcpServer;
     private transport?;
+    private logger;
     constructor(courseDB: CourseDBInterface, options?: MCPServerOptions);
     private setupCapabilities;
     start(transport: Transport): Promise<void>;
@@ -39,50 +41,40 @@ interface CardResource {
     elo: number;
 }
 
+declare const CreateCardInputMCPSchema: {
+    datashape: z.ZodString;
+    data: z.ZodAny;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    elo: z.ZodOptional<z.ZodNumber>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+};
 declare const CreateCardInputSchema: z.ZodObject<{
     datashape: z.ZodString;
     data: z.ZodAny;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     elo: z.ZodOptional<z.ZodNumber>;
     sourceRef: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    datashape: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}, {
-    datashape: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}>;
+}, z.core.$strip>;
 type CreateCardInput = z.infer<typeof CreateCardInputSchema>;
 interface CreateCardOutput {
     cardId: string;
     initialElo: number;
     created: boolean;
 }
+declare const UpdateCardInputMCPSchema: {
+    cardId: z.ZodString;
+    data: z.ZodOptional<z.ZodAny>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    elo: z.ZodOptional<z.ZodNumber>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+};
 declare const UpdateCardInputSchema: z.ZodObject<{
     cardId: z.ZodString;
     data: z.ZodOptional<z.ZodAny>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     elo: z.ZodOptional<z.ZodNumber>;
     sourceRef: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    cardId: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}, {
-    cardId: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}>;
+}, z.core.$strip>;
 type UpdateCardInput = z.infer<typeof UpdateCardInputSchema>;
 interface UpdateCardOutput {
     cardId: string;
@@ -94,22 +86,24 @@ interface UpdateCardOutput {
         sourceRef?: boolean;
     };
 }
+declare const TagCardInputMCPSchema: {
+    cardId: z.ZodString;
+    action: z.ZodEnum<{
+        add: "add";
+        remove: "remove";
+    }>;
+    tags: z.ZodArray<z.ZodString>;
+    updateELO: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+};
 declare const TagCardInputSchema: z.ZodObject<{
     cardId: z.ZodString;
-    action: z.ZodEnum<["add", "remove"]>;
-    tags: z.ZodArray<z.ZodString, "many">;
+    action: z.ZodEnum<{
+        add: "add";
+        remove: "remove";
+    }>;
+    tags: z.ZodArray<z.ZodString>;
     updateELO: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    cardId: string;
-    tags: string[];
-    action: "add" | "remove";
-    updateELO: boolean;
-}, {
-    cardId: string;
-    tags: string[];
-    action: "add" | "remove";
-    updateELO?: boolean | undefined;
-}>;
+}, z.core.$strip>;
 type TagCardInput = z.infer<typeof TagCardInputSchema>;
 interface TagCardOutput {
     cardId: string;
@@ -118,19 +112,16 @@ interface TagCardOutput {
     success: boolean;
     currentTags: string[];
 }
+declare const DeleteCardInputMCPSchema: {
+    cardId: z.ZodString;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+};
 declare const DeleteCardInputSchema: z.ZodObject<{
     cardId: z.ZodString;
     confirm: z.ZodDefault<z.ZodBoolean>;
     reason: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    cardId: string;
-    confirm: boolean;
-    reason?: string | undefined;
-}, {
-    cardId: string;
-    confirm?: boolean | undefined;
-    reason?: string | undefined;
-}>;
+}, z.core.$strip>;
 type DeleteCardInput = z.infer<typeof DeleteCardInputSchema>;
 interface DeleteCardOutput {
     cardId: string;
@@ -220,7 +211,7 @@ interface ShapesCollection {
 /**
  * Handle shapes://all resource - List all available DataShapes
  */
-declare function handleShapesAllResource(courseDB: CourseDBInterface): Promise<ShapesCollection>;
+declare function handleShapesAllResource(_courseDB: CourseDBInterface): Promise<ShapesCollection>;
 /**
  * Handle shapes://[shapeName] resource - Get specific DataShape definition
  */
@@ -299,6 +290,22 @@ declare function handleTagsDistributionResource(courseDB: CourseDBInterface): Pr
     totalCards: number;
 }>;
 
+/**
+ * Schema resource response structure
+ */
+interface SchemaResource {
+    dataShapeName: string;
+    jsonSchema: object;
+    schemaString: string;
+    available: boolean;
+    lastUpdated?: string;
+}
+/**
+ * Handle schema resource request for a specific DataShape
+ * Returns the JSON Schema for the DataShape if available
+ */
+declare function handleSchemaResource(_courseDB: CourseDBInterface, dataShapeName: string): Promise<SchemaResource>;
+
 declare const RESOURCE_PATTERNS: {
     readonly COURSE_CONFIG: "course://config";
     readonly CARDS_ALL: "cards://all";
@@ -314,6 +321,7 @@ declare const RESOURCE_PATTERNS: {
     readonly TAGS_INTERSECT: "tags://intersect/{tags}";
     readonly TAGS_EXCLUSIVE: "tags://exclusive/{tags}";
     readonly TAGS_DISTRIBUTION: "tags://distribution";
+    readonly SCHEMA_SPECIFIC: "schema://{dataShapeName}";
 };
 
 declare function handleCreateCard(courseDB: CourseDBInterface, input: CreateCardInput): Promise<CreateCardOutput>;
@@ -331,4 +339,4 @@ declare const TOOL_PATTERNS: {
     readonly DELETE_CARD: "delete_card";
 };
 
-export { type CardResource, type CardResourceData, type CardsCollection, type ContentWithELO, type CourseConfigUri, CourseConfigUriSchema, type CourseResource, type CreateCardInput, CreateCardInputSchema, type CreateCardOutput, type DeleteCardInput, DeleteCardInputSchema, type DeleteCardOutput, type ELOContext, MCPServer, type MCPServerOptions, RESOURCE_PATTERNS, type ShapeResource, type ShapesCollection, type SourceReference, TOOL_PATTERNS, type TagCardInput, TagCardInputSchema, type TagCardOutput, type TagDistribution, type TagResource, type TagsCollection, type UpdateCardInput, UpdateCardInputSchema, type UpdateCardOutput, handleCardsAllResource, handleCardsEloResource, handleCardsShapeResource, handleCardsTagResource, handleCourseConfigResource, handleCreateCard, handleDeleteCard, handleShapeSpecificResource, handleShapesAllResource, handleTagCard, handleTagSpecificResource, handleTagsAllResource, handleTagsDistributionResource, handleTagsExclusiveResource, handleTagsIntersectResource, handleTagsStatsResource, handleTagsUnionResource, handleUpdateCard };
+export { type CardResource, type CardResourceData, type CardsCollection, type ContentWithELO, type CourseConfigUri, CourseConfigUriSchema, type CourseResource, type CreateCardInput, CreateCardInputMCPSchema, CreateCardInputSchema, type CreateCardOutput, type DeleteCardInput, DeleteCardInputMCPSchema, DeleteCardInputSchema, type DeleteCardOutput, type ELOContext, MCPServer, type MCPServerOptions, RESOURCE_PATTERNS, type SchemaResource, type ShapeResource, type ShapesCollection, type SourceReference, TOOL_PATTERNS, type TagCardInput, TagCardInputMCPSchema, TagCardInputSchema, type TagCardOutput, type TagDistribution, type TagResource, type TagsCollection, type UpdateCardInput, UpdateCardInputMCPSchema, UpdateCardInputSchema, type UpdateCardOutput, handleCardsAllResource, handleCardsEloResource, handleCardsShapeResource, handleCardsTagResource, handleCourseConfigResource, handleCreateCard, handleDeleteCard, handleSchemaResource, handleShapeSpecificResource, handleShapesAllResource, handleTagCard, handleTagSpecificResource, handleTagsAllResource, handleTagsDistributionResource, handleTagsExclusiveResource, handleTagsIntersectResource, handleTagsStatsResource, handleTagsUnionResource, handleUpdateCard };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
 import { CourseDBInterface } from '@vue-skuilder/db';
-import { CourseConfig } from '@vue-skuilder/common';
+import { SkLogger, CourseConfig } from '@vue-skuilder/common';
 import { z } from 'zod';
 
 interface MCPServerOptions {
@@ -9,12 +9,14 @@ interface MCPServerOptions {
     maxCardsPerQuery?: number;
     allowedDataShapes?: string[];
     eloCalibrationMode?: 'strict' | 'adaptive' | 'manual';
+    logger?: SkLogger;
 }
 declare class MCPServer {
     private courseDB;
     private readonly options;
     private mcpServer;
     private transport?;
+    private logger;
     constructor(courseDB: CourseDBInterface, options?: MCPServerOptions);
     private setupCapabilities;
     start(transport: Transport): Promise<void>;
@@ -39,50 +41,40 @@ interface CardResource {
     elo: number;
 }
 
+declare const CreateCardInputMCPSchema: {
+    datashape: z.ZodString;
+    data: z.ZodAny;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    elo: z.ZodOptional<z.ZodNumber>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+};
 declare const CreateCardInputSchema: z.ZodObject<{
     datashape: z.ZodString;
     data: z.ZodAny;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     elo: z.ZodOptional<z.ZodNumber>;
     sourceRef: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    datashape: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}, {
-    datashape: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}>;
+}, z.core.$strip>;
 type CreateCardInput = z.infer<typeof CreateCardInputSchema>;
 interface CreateCardOutput {
     cardId: string;
     initialElo: number;
     created: boolean;
 }
+declare const UpdateCardInputMCPSchema: {
+    cardId: z.ZodString;
+    data: z.ZodOptional<z.ZodAny>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    elo: z.ZodOptional<z.ZodNumber>;
+    sourceRef: z.ZodOptional<z.ZodString>;
+};
 declare const UpdateCardInputSchema: z.ZodObject<{
     cardId: z.ZodString;
     data: z.ZodOptional<z.ZodAny>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     elo: z.ZodOptional<z.ZodNumber>;
     sourceRef: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    cardId: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}, {
-    cardId: string;
-    elo?: number | undefined;
-    tags?: string[] | undefined;
-    data?: any;
-    sourceRef?: string | undefined;
-}>;
+}, z.core.$strip>;
 type UpdateCardInput = z.infer<typeof UpdateCardInputSchema>;
 interface UpdateCardOutput {
     cardId: string;
@@ -94,22 +86,24 @@ interface UpdateCardOutput {
         sourceRef?: boolean;
     };
 }
+declare const TagCardInputMCPSchema: {
+    cardId: z.ZodString;
+    action: z.ZodEnum<{
+        add: "add";
+        remove: "remove";
+    }>;
+    tags: z.ZodArray<z.ZodString>;
+    updateELO: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+};
 declare const TagCardInputSchema: z.ZodObject<{
     cardId: z.ZodString;
-    action: z.ZodEnum<["add", "remove"]>;
-    tags: z.ZodArray<z.ZodString, "many">;
+    action: z.ZodEnum<{
+        add: "add";
+        remove: "remove";
+    }>;
+    tags: z.ZodArray<z.ZodString>;
     updateELO: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strip", z.ZodTypeAny, {
-    cardId: string;
-    tags: string[];
-    action: "add" | "remove";
-    updateELO: boolean;
-}, {
-    cardId: string;
-    tags: string[];
-    action: "add" | "remove";
-    updateELO?: boolean | undefined;
-}>;
+}, z.core.$strip>;
 type TagCardInput = z.infer<typeof TagCardInputSchema>;
 interface TagCardOutput {
     cardId: string;
@@ -118,19 +112,16 @@ interface TagCardOutput {
     success: boolean;
     currentTags: string[];
 }
+declare const DeleteCardInputMCPSchema: {
+    cardId: z.ZodString;
+    confirm: z.ZodDefault<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+};
 declare const DeleteCardInputSchema: z.ZodObject<{
     cardId: z.ZodString;
     confirm: z.ZodDefault<z.ZodBoolean>;
     reason: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    cardId: string;
-    confirm: boolean;
-    reason?: string | undefined;
-}, {
-    cardId: string;
-    confirm?: boolean | undefined;
-    reason?: string | undefined;
-}>;
+}, z.core.$strip>;
 type DeleteCardInput = z.infer<typeof DeleteCardInputSchema>;
 interface DeleteCardOutput {
     cardId: string;
@@ -220,7 +211,7 @@ interface ShapesCollection {
 /**
  * Handle shapes://all resource - List all available DataShapes
  */
-declare function handleShapesAllResource(courseDB: CourseDBInterface): Promise<ShapesCollection>;
+declare function handleShapesAllResource(_courseDB: CourseDBInterface): Promise<ShapesCollection>;
 /**
  * Handle shapes://[shapeName] resource - Get specific DataShape definition
  */
@@ -299,6 +290,22 @@ declare function handleTagsDistributionResource(courseDB: CourseDBInterface): Pr
     totalCards: number;
 }>;
 
+/**
+ * Schema resource response structure
+ */
+interface SchemaResource {
+    dataShapeName: string;
+    jsonSchema: object;
+    schemaString: string;
+    available: boolean;
+    lastUpdated?: string;
+}
+/**
+ * Handle schema resource request for a specific DataShape
+ * Returns the JSON Schema for the DataShape if available
+ */
+declare function handleSchemaResource(_courseDB: CourseDBInterface, dataShapeName: string): Promise<SchemaResource>;
+
 declare const RESOURCE_PATTERNS: {
     readonly COURSE_CONFIG: "course://config";
     readonly CARDS_ALL: "cards://all";
@@ -314,6 +321,7 @@ declare const RESOURCE_PATTERNS: {
     readonly TAGS_INTERSECT: "tags://intersect/{tags}";
     readonly TAGS_EXCLUSIVE: "tags://exclusive/{tags}";
     readonly TAGS_DISTRIBUTION: "tags://distribution";
+    readonly SCHEMA_SPECIFIC: "schema://{dataShapeName}";
 };
 
 declare function handleCreateCard(courseDB: CourseDBInterface, input: CreateCardInput): Promise<CreateCardOutput>;
@@ -331,4 +339,4 @@ declare const TOOL_PATTERNS: {
     readonly DELETE_CARD: "delete_card";
 };
 
-export { type CardResource, type CardResourceData, type CardsCollection, type ContentWithELO, type CourseConfigUri, CourseConfigUriSchema, type CourseResource, type CreateCardInput, CreateCardInputSchema, type CreateCardOutput, type DeleteCardInput, DeleteCardInputSchema, type DeleteCardOutput, type ELOContext, MCPServer, type MCPServerOptions, RESOURCE_PATTERNS, type ShapeResource, type ShapesCollection, type SourceReference, TOOL_PATTERNS, type TagCardInput, TagCardInputSchema, type TagCardOutput, type TagDistribution, type TagResource, type TagsCollection, type UpdateCardInput, UpdateCardInputSchema, type UpdateCardOutput, handleCardsAllResource, handleCardsEloResource, handleCardsShapeResource, handleCardsTagResource, handleCourseConfigResource, handleCreateCard, handleDeleteCard, handleShapeSpecificResource, handleShapesAllResource, handleTagCard, handleTagSpecificResource, handleTagsAllResource, handleTagsDistributionResource, handleTagsExclusiveResource, handleTagsIntersectResource, handleTagsStatsResource, handleTagsUnionResource, handleUpdateCard };
+export { type CardResource, type CardResourceData, type CardsCollection, type ContentWithELO, type CourseConfigUri, CourseConfigUriSchema, type CourseResource, type CreateCardInput, CreateCardInputMCPSchema, CreateCardInputSchema, type CreateCardOutput, type DeleteCardInput, DeleteCardInputMCPSchema, DeleteCardInputSchema, type DeleteCardOutput, type ELOContext, MCPServer, type MCPServerOptions, RESOURCE_PATTERNS, type SchemaResource, type ShapeResource, type ShapesCollection, type SourceReference, TOOL_PATTERNS, type TagCardInput, TagCardInputMCPSchema, TagCardInputSchema, type TagCardOutput, type TagDistribution, type TagResource, type TagsCollection, type UpdateCardInput, UpdateCardInputMCPSchema, UpdateCardInputSchema, type UpdateCardOutput, handleCardsAllResource, handleCardsEloResource, handleCardsShapeResource, handleCardsTagResource, handleCourseConfigResource, handleCreateCard, handleDeleteCard, handleSchemaResource, handleShapeSpecificResource, handleShapesAllResource, handleTagCard, handleTagSpecificResource, handleTagsAllResource, handleTagsDistributionResource, handleTagsExclusiveResource, handleTagsIntersectResource, handleTagsStatsResource, handleTagsUnionResource, handleUpdateCard };