@fullstackcraftllc/codevideo-mcp 1.0.0 → 1.0.2

package/dist/src/constants/Constants.d.ts

@@ -0,0 +1,2 @@
+export declare const CURRENT_ACTIONS_KEY = "current_actions";
+export declare const CURRENT_LESSON_KEY = "current_lesson";

package/dist/src/index.d.ts

@@ -1 +1,2 @@
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createMcpServer(): McpServer;

package/dist/src/prompts/instructions_to_translate_actions.d.ts

@@ -0,0 +1,2 @@
+import { IAction } from "@fullstackcraftllc/codevideo-types";
+export declare const instructionsToTranslateActions: (actionsToTranslation: Array<IAction> | undefined, targetLanguage: string) => string;

package/dist/src/resources/get_example_actions_array_by_keyword.d.ts

@@ -0,0 +1 @@
+export declare const getExampleActionsArrayByKeyword: (keyword: string | string[]) => string;

package/dist/src/resources/get_example_lessons_by_keyword.d.ts

@@ -0,0 +1 @@
+export declare const getExampleLessonByKeyword: (keyword: string | string[]) => string;

package/dist/src/rest-server/index.d.ts

@@ -0,0 +1,24 @@
+import express from 'express';
+declare class RestMcpServer {
+    app: express.Application;
+    private httpServer;
+    private io;
+    private jobManager;
+    private mcpServer;
+    private mcpClient;
+    private mcpTransport;
+    private tasks;
+    private port;
+    constructor(port?: number);
+    private setupMiddleware;
+    private initializeMcpServer;
+    private setupRoutes;
+    private setupWebSocket;
+    private processRequest;
+    private processPrompt;
+    private processTool;
+    private notifyTaskUpdate;
+    start(): void;
+    stop(): void;
+}
+export { RestMcpServer };

package/dist/src/rest-server/job-manager.d.ts

@@ -0,0 +1,56 @@
+import { EventEmitter } from 'events';
+interface Job {
+    id: string;
+    taskId: string;
+    type: string;
+    data: any;
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+    createdAt: Date;
+    startedAt?: Date;
+    completedAt?: Date;
+    retryCount: number;
+    maxRetries: number;
+    priority: number;
+    timeout?: number;
+}
+export declare class JobManager extends EventEmitter {
+    private jobs;
+    private queue;
+    private workers;
+    private isRunning;
+    private maxConcurrentJobs;
+    private pollInterval;
+    constructor(maxConcurrentJobs?: number);
+    addJob(taskId: string, type: string, data: any, options?: {
+        priority?: number;
+        maxRetries?: number;
+        timeout?: number;
+    }): string;
+    getJob(jobId: string): Job | undefined;
+    cancelJob(taskId: string): boolean;
+    getQueueStatus(): {
+        pending: number;
+        running: number;
+        completed: number;
+        failed: number;
+        cancelled: number;
+    };
+    getQueueInfo(): {
+        queueLength: number;
+        activeWorkers: number;
+        totalJobs: number;
+        status: {
+            [key: string]: number;
+        };
+    };
+    private enqueue;
+    private processNextJob;
+    private executeJob;
+    private getJobExecutionTime;
+    private handleJobTimeout;
+    private start;
+    private processQueue;
+    shutdown(): void;
+    clearCompleted(): number;
+}
+export {};

package/dist/src/rest-server/mcp-client.d.ts

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+interface McpToolCall {
+    name: string;
+    arguments: any;
+}
+interface McpResponse {
+    content: any[];
+    isError?: boolean;
+}
+export declare class McpClient {
+    private server;
+    private isConnected;
+    constructor(server: McpServer);
+    connect(): Promise<void>;
+    listTools(): Promise<any[]>;
+    callTool(toolCall: McpToolCall): Promise<McpResponse>;
+    getPrompts(): Promise<any[]>;
+    getPrompt(name: string, args?: any): Promise<any>;
+    getResources(): Promise<any[]>;
+    readResource(uri: string): Promise<any>;
+    disconnect(): void;
+}
+export {};

package/dist/src/rest-server/rest-server.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+import express from 'express';
+declare class RestMcpServer {
+    app: express.Application;
+    private httpServer;
+    private io;
+    private jobManager;
+    private mcpServer;
+    private mcpClient;
+    private tasks;
+    private port;
+    constructor(port?: number);
+    private setupMiddleware;
+    private initializeMcpServer;
+    private setupRoutes;
+    private setupWebSocket;
+    private processRequest;
+    private processPrompt;
+    private processTool;
+    private notifyTaskUpdate;
+    start(): void;
+    stop(): void;
+}
+export { RestMcpServer };

package/dist/src/rest-server/server.d.ts

@@ -0,0 +1,4 @@
+import { RestMcpServer } from './rest-server';
+import { McpClient } from './mcp-client';
+export declare function createRestServerFromMcp(): RestMcpServer;
+export { RestMcpServer, McpClient };

package/dist/src/tools/get_current_lesson.d.ts

@@ -0,0 +1,3 @@
+import { ILesson } from "@fullstackcraftllc/codevideo-types";
+export declare const getCurrentLesson: () => ILesson | null;
+export declare const getCurrentLessonOrThrow: () => ILesson;

package/dist/src/tools/get_initial_lesson_state_from_github_repo.d.ts

@@ -0,0 +1 @@
+export declare const getInitialLessonStateFromGitHubRepo: (repoUrl: string) => Promise<string>;

package/dist/src/tools/{make_video.d.ts → make_video_from_actions.d.ts}

@@ -5,4 +5,4 @@ export interface VideoResult {
     stderr: string;
     error?: any;
 }
-export declare const makeVideo: (actions?: IAction[]) => Promise<VideoResult>;
+export declare const makeVideoFromActions: (actions?: IAction[]) => Promise<VideoResult>;

package/dist/src/tools/make_video_from_lesson.d.ts

@@ -0,0 +1,8 @@
+import { ILesson } from "@fullstackcraftllc/codevideo-types";
+export interface VideoResult {
+    outputPath: string;
+    stdout: string;
+    stderr: string;
+    error?: any;
+}
+export declare const makeVideoFromLesson: (lesson?: ILesson) => Promise<VideoResult>;

package/dist/src/tools/set_current_lesson.d.ts

@@ -0,0 +1,2 @@
+import { ILesson } from "@fullstackcraftllc/codevideo-types";
+export declare const setCurrentLesson: (lesson: ILesson) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullstackcraftllc/codevideo-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "The MCP server for CodeVideo. Create software educational content using natural language.",
   "type": "module",
   "main": "dist/index.cjs.js",
@@ -20,7 +20,11 @@
     "build-typescript": "tsc",
     "test": "jest",
     "type-check": "tsc --noEmit",
-    "download-binaries": "tsx scripts/download-binaries.ts"
+    "download-binaries": "tsx scripts/download-binaries.ts",
+    "rest-server": "tsx src/rest-server/server.ts",
+    "rest-server:dev": "tsx --watch src/rest-server/server.ts",
+    "client:example": "tsx examples/rest-client.ts",
+    "examples:curl": "./examples/curl-examples.sh"
   },
   "repository": {
     "type": "git",
@@ -39,21 +43,31 @@
   },
   "homepage": "https://github.com/codevideo/codevideo-mcp#readme",
   "dependencies": {
-    "@fullstackcraftllc/codevideo-adapters": "^1.0.0",
+    "@fullstackcraftllc/codevideo-adapters": "^1.0.12",
     "@fullstackcraftllc/codevideo-exporters": "^0.0.9",
-    "@fullstackcraftllc/codevideo-types": "^2.1.20",
+    "@fullstackcraftllc/codevideo-types": "^2.1.26",
     "@google/genai": "^0.14.1",
     "@modelcontextprotocol/sdk": "^1.10.0",
     "@types/better-sqlite3": "^7.6.13",
     "better-sqlite3": "^11.10.0",
-    "dotenv": "^16.5.0"
+    "cors": "^2.8.5",
+    "dotenv": "^16.5.0",
+    "express": "^4.21.2",
+    "node-fetch": "^3.3.2",
+    "socket.io": "^4.8.1",
+    "uuid": "^9.0.1",
+    "ws": "^8.18.2"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^28.0.3",
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^16.0.1",
     "@rollup/plugin-typescript": "^12.1.2",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^4.17.23",
     "@types/node": "^22.14.1",
+    "@types/uuid": "^9.0.8",
+    "@types/ws": "^8.18.1",
     "rimraf": "^6.0.1",
     "rollup": "^4.40.0",
     "rollup-plugin-dts": "^6.2.1",

package/dist/src/resources/get_example_lesson.d.ts

@@ -1 +0,0 @@
-export declare const getExampleLesson: (keyword: string | string[]) => string;