sub-agents-mcp 0.1.2

package/dist/server/McpServer.js

@@ -0,0 +1,373 @@
+"use strict";
+/**
+ * MCP Server implementation using @modelcontextprotocol/sdk
+ *
+ * Provides the foundational MCP server functionality with StdioServerTransport
+ * for stdin/stdout communication. This class serves as the entry point for
+ * the MCP server and handles basic server lifecycle operations.
+ *
+ * @example
+ * ```typescript
+ * const config = await ServerConfig.fromEnvironment()
+ * const server = new McpServer(config)
+ * await server.start()
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.McpServer = void 0;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const AgentManager_1 = require("../agents/AgentManager");
+const AgentExecutor_1 = require("../execution/AgentExecutor");
+const AgentResources_1 = require("../resources/AgentResources");
+const RunAgentTool_1 = require("../tools/RunAgentTool");
+const ErrorHandler_1 = require("../utils/ErrorHandler");
+const Logger_1 = require("../utils/Logger");
+/**
+ * MCP Server class providing foundational server functionality
+ */
+class McpServer {
+    /**
+     * Create a new MCP server instance
+     * @param config Server configuration object
+     * @throws {Error} When server name is empty
+     */
+    constructor(config) {
+        this.transport = null;
+        this.validateConfig(config);
+        this.config = config;
+        this.log('info', 'Initializing MCP server', {
+            name: config.serverName,
+            version: config.serverVersion,
+        });
+        // Initialize agent management components
+        this.agentManager = new AgentManager_1.AgentManager(config);
+        // Create ExecutionConfig with the agent type from server config
+        const executionConfig = (0, AgentExecutor_1.createExecutionConfig)(config.agentType, {
+            executionTimeout: config.executionTimeoutMs, // Use timeout from config (env var or 90s default)
+        });
+        // Create logger with log level from config
+        const executorLogger = new Logger_1.Logger(config.logLevel);
+        this.agentExecutor = new AgentExecutor_1.AgentExecutor(executionConfig, executorLogger);
+        this.runAgentTool = new RunAgentTool_1.RunAgentTool(this.agentExecutor, this.agentManager);
+        this.agentResources = new AgentResources_1.AgentResources(this.agentManager);
+        // Initialize MCP server with capabilities
+        this.server = new index_js_1.Server({
+            name: config.serverName,
+            version: config.serverVersion,
+        }, {
+            capabilities: {
+                tools: {},
+                resources: {},
+            },
+        });
+        // Setup StdioServerTransport for stdin/stdout communication
+        this.setupTransport();
+        // Setup MCP handlers
+        this.setupHandlers();
+        this.log('info', 'MCP server initialized successfully');
+    }
+    /**
+     * Validate server configuration
+     * @param config Configuration to validate
+     * @throws {Error} When configuration is invalid
+     */
+    validateConfig(config) {
+        if (!config.serverName || config.serverName.trim() === '') {
+            throw new Error('Server name cannot be empty');
+        }
+        if (!config.serverVersion || config.serverVersion.trim() === '') {
+            throw new Error('Server version cannot be empty');
+        }
+    }
+    /**
+     * Log message with structured format
+     * @param level Log level
+     * @param message Log message
+     * @param metadata Additional metadata
+     */
+    log(level, message, metadata) {
+        const logLevels = {
+            debug: 0,
+            info: 1,
+            warn: 2,
+            error: 3,
+        };
+        if (logLevels[level] >= logLevels[this.config.logLevel]) {
+            const timestamp = new Date().toISOString();
+            const logEntry = {
+                timestamp,
+                level,
+                message,
+                service: 'mcp-server',
+                ...metadata,
+            };
+            console.log(JSON.stringify(logEntry));
+        }
+    }
+    /**
+     * Setup StdioServerTransport for MCP communication
+     */
+    setupTransport() {
+        try {
+            this.transport = new stdio_js_1.StdioServerTransport();
+            this.log('debug', 'StdioServerTransport configured successfully');
+        }
+        catch (error) {
+            this.log('error', 'Failed to setup transport', { error: String(error) });
+            throw new ErrorHandler_1.AppError('Failed to setup MCP transport', 'TRANSPORT_SETUP_FAILED');
+        }
+    }
+    /**
+     * Setup MCP protocol handlers with performance monitoring
+     */
+    setupHandlers() {
+        try {
+            // List tools handler
+            this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+                const startTime = Date.now();
+                this.log('debug', 'Received list_tools request');
+                try {
+                    const result = {
+                        tools: [
+                            {
+                                name: this.runAgentTool.name,
+                                description: this.runAgentTool.description,
+                                inputSchema: this.runAgentTool.inputSchema,
+                            },
+                        ],
+                    };
+                    this.log('debug', 'List tools request completed', {
+                        responseTime: Date.now() - startTime,
+                        toolCount: result.tools.length,
+                    });
+                    return result;
+                }
+                catch (error) {
+                    this.log('error', 'List tools request failed', {
+                        responseTime: Date.now() - startTime,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error;
+                }
+            });
+            // Call tool handler
+            this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+                const startTime = Date.now();
+                const { params } = request;
+                this.log('debug', 'Received call_tool request', { tool: params.name });
+                try {
+                    if (params.name === 'run_agent') {
+                        const result = await this.runAgentTool.execute(params.arguments);
+                        this.log('info', 'Tool execution completed', {
+                            tool: params.name,
+                            responseTime: Date.now() - startTime,
+                            success: true,
+                        });
+                        return result;
+                    }
+                    throw new ErrorHandler_1.ValidationError(`Unknown tool: ${params.name}`, 'UNKNOWN_TOOL');
+                }
+                catch (error) {
+                    this.log('error', 'Tool execution failed', {
+                        tool: params.name,
+                        responseTime: Date.now() - startTime,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error;
+                }
+            });
+            // List resources handler
+            this.server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => {
+                const startTime = Date.now();
+                this.log('debug', 'Received list_resources request');
+                try {
+                    const resources = await this.agentResources.listResources();
+                    this.log('debug', 'List resources request completed', {
+                        responseTime: Date.now() - startTime,
+                        resourceCount: resources.length,
+                    });
+                    return { resources };
+                }
+                catch (error) {
+                    this.log('error', 'List resources request failed', {
+                        responseTime: Date.now() - startTime,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error;
+                }
+            });
+            // Read resource handler
+            this.server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+                const startTime = Date.now();
+                const { params } = request;
+                this.log('debug', 'Received read_resource request', { uri: params.uri });
+                try {
+                    if (!this.agentResources.isValidResourceUri(params.uri)) {
+                        throw new ErrorHandler_1.ValidationError(`Invalid resource URI: ${params.uri}`, 'INVALID_RESOURCE_URI');
+                    }
+                    const result = await this.agentResources.readResource(params.uri);
+                    this.log('debug', 'Read resource request completed', {
+                        uri: params.uri,
+                        responseTime: Date.now() - startTime,
+                        contentLength: result.contents[0]?.text?.length || 0,
+                    });
+                    return result;
+                }
+                catch (error) {
+                    this.log('error', 'Read resource request failed', {
+                        uri: params.uri,
+                        responseTime: Date.now() - startTime,
+                        error: error instanceof Error ? error.message : String(error),
+                    });
+                    throw error;
+                }
+            });
+            this.log('debug', 'MCP handlers configured successfully');
+        }
+        catch (error) {
+            this.log('error', 'Failed to setup MCP handlers', { error: String(error) });
+            throw new ErrorHandler_1.AppError('Failed to setup MCP handlers', 'HANDLERS_SETUP_FAILED');
+        }
+    }
+    /**
+     * Get server information
+     * @returns Server name and version
+     */
+    getServerInfo() {
+        return {
+            name: this.config.serverName,
+            version: this.config.serverVersion,
+        };
+    }
+    /**
+     * Check if transport is configured
+     * @returns True if transport is available
+     */
+    hasTransport() {
+        return this.transport !== null;
+    }
+    /**
+     * Check if server is ready to start
+     * @returns True if server is ready
+     */
+    isReady() {
+        return this.hasTransport() && this.server !== null;
+    }
+    /**
+     * Start the MCP server
+     * @throws {Error} When server is not ready or transport setup fails
+     */
+    async start() {
+        try {
+            if (!this.isReady()) {
+                throw new ErrorHandler_1.AppError('Server is not ready to start', 'SERVER_NOT_READY');
+            }
+            if (!this.transport) {
+                throw new ErrorHandler_1.AppError('Transport not configured', 'TRANSPORT_NOT_CONFIGURED');
+            }
+            this.log('info', 'Starting MCP server...');
+            // Connect server to transport
+            await this.server.connect(this.transport);
+            this.log('info', 'MCP server started successfully', {
+                serverName: this.config.serverName,
+                serverVersion: this.config.serverVersion,
+            });
+        }
+        catch (error) {
+            this.log('error', 'Failed to start MCP server', { error: String(error) });
+            throw error instanceof ErrorHandler_1.AppError
+                ? error
+                : new ErrorHandler_1.AppError('Failed to start MCP server', 'SERVER_START_FAILED');
+        }
+    }
+    /**
+     * List available tools (for testing)
+     * @returns Promise resolving to array of tool definitions
+     */
+    async listTools() {
+        return [
+            {
+                name: this.runAgentTool.name,
+                description: this.runAgentTool.description,
+                inputSchema: this.runAgentTool.inputSchema,
+            },
+        ];
+    }
+    /**
+     * List available resources (for testing)
+     * @returns Promise resolving to array of resource definitions
+     */
+    async listResources() {
+        const resources = await this.agentResources.listResources();
+        return resources.map((resource) => ({
+            uri: resource.uri,
+            name: resource.name,
+            description: resource.description,
+        }));
+    }
+    /**
+     * Call a tool (for testing)
+     * @param toolName - Name of the tool to call
+     * @param params - Tool parameters
+     * @returns Promise resolving to tool response
+     */
+    async callTool(toolName, params) {
+        if (toolName === 'run_agent') {
+            return await this.runAgentTool.execute(params);
+        }
+        throw new ErrorHandler_1.ValidationError(`Unknown tool: ${toolName}`, 'UNKNOWN_TOOL');
+    }
+    /**
+     * Read a resource (for testing)
+     * @param uri - Resource URI to read
+     * @returns Promise resolving to resource content
+     */
+    async readResource(uri) {
+        if (!this.agentResources.isValidResourceUri(uri)) {
+            throw new ErrorHandler_1.ValidationError(`Invalid resource URI: ${uri}`, 'INVALID_RESOURCE_URI');
+        }
+        return await this.agentResources.readResource(uri);
+    }
+    /**
+     * Get server performance statistics
+     *
+     * @returns Performance and usage statistics
+     */
+    getServerStats() {
+        return {
+            serverInfo: this.getServerInfo(),
+            executionStats: this.runAgentTool.getExecutionStats(),
+        };
+    }
+    /**
+     * Reset statistics
+     */
+    resetStats() {
+        this.log('info', 'Server statistics reset');
+    }
+    /**
+     * Close the server and cleanup resources
+     */
+    async close() {
+        try {
+            this.log('info', 'Shutting down MCP server...');
+            // Log final statistics before shutdown
+            const stats = this.getServerStats();
+            this.log('info', 'Final server statistics', {
+                executionCount: Array.from(stats.executionStats.values()).reduce((sum, stat) => sum + stat.count, 0),
+            });
+            if (this.server) {
+                await this.server.close();
+            }
+            this.log('info', 'MCP server shutdown completed');
+        }
+        catch (error) {
+            this.log('error', 'Error during server shutdown', { error: String(error) });
+            throw new ErrorHandler_1.AppError('Failed to shutdown MCP server gracefully', 'SERVER_SHUTDOWN_FAILED');
+        }
+    }
+}
+exports.McpServer = McpServer;
+//# sourceMappingURL=McpServer.js.map

package/dist/server/McpServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServer.js","sourceRoot":"","sources":["../../src/server/McpServer.ts"],"names":[],"mappings":"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"}

package/dist/tools/RunAgentTool.d.ts

@@ -0,0 +1,140 @@
+/**
+ * RunAgentTool implementation for executing Claude Code sub-agents via MCP
+ *
+ * Provides the run_agent tool that allows MCP clients to execute specific
+ * agents with parameters, integrating with AgentExecutor and AgentManager
+ * for complete agent execution workflow.
+ */
+import type { AgentManager } from '../agents/AgentManager';
+import type { AgentExecutor } from '../execution/AgentExecutor';
+/**
+ * MCP tool content type for text responses
+ */
+interface McpTextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * MCP tool response format
+ */
+interface McpToolResponse {
+    content: McpTextContent[];
+    isError?: boolean;
+    structuredContent?: unknown;
+}
+/**
+ * Input schema for run_agent tool parameters
+ */
+interface RunAgentInputSchema {
+    [x: string]: unknown;
+    type: 'object';
+    properties: {
+        [x: string]: unknown;
+        agent: {
+            type: 'string';
+            description: string;
+        };
+        prompt: {
+            type: 'string';
+            description: string;
+        };
+        cwd: {
+            type: 'string';
+            description: string;
+        };
+        extra_args: {
+            type: 'array';
+            items: {
+                type: 'string';
+            };
+            description: string;
+        };
+    };
+    required: string[];
+}
+/**
+ * RunAgentTool class implementing the run_agent MCP tool
+ *
+ * Provides execution of Claude Code sub-agents with parameter validation,
+ * error handling, and proper MCP response formatting.
+ */
+export declare class RunAgentTool {
+    private agentExecutor?;
+    private agentManager?;
+    readonly name = "run_agent";
+    readonly description = "Execute a Claude Code sub-agent with specified parameters";
+    private logger;
+    private executionStats;
+    readonly inputSchema: RunAgentInputSchema;
+    constructor(agentExecutor?: AgentExecutor | undefined, agentManager?: AgentManager | undefined);
+    /**
+     * Execute the run_agent tool with the provided parameters
+     *
+     * @param params - Tool execution parameters
+     * @returns Promise resolving to MCP tool response
+     * @throws {Error} When parameters are invalid or execution fails
+     */
+    execute(params: unknown): Promise<McpToolResponse>;
+    /**
+     * Validate and type-check the input parameters with comprehensive validation
+     *
+     * @private
+     * @param params - Raw parameters to validate
+     * @returns Validated parameters
+     * @throws {Error} When parameters are invalid
+     */
+    private validateParams;
+    /**
+     * Format agent execution response
+     *
+     * @private
+     * @param result - Agent execution result
+     * @param agentName - Name of the executed agent
+     * @param requestId - Request tracking ID
+     * @returns Formatted MCP response
+     */
+    private formatExecutionResponse;
+    /**
+     * Create error response with optional available agents list
+     *
+     * @private
+     * @param errorMessage - Error message to display
+     * @param availableAgents - Optional list of available agents
+     * @returns Error response in MCP format
+     */
+    private createErrorResponse;
+    /**
+     * Generate unique request ID for tracking
+     *
+     * @private
+     * @returns Unique request identifier
+     */
+    private generateRequestId;
+    /**
+     * Update execution statistics
+     *
+     * @private
+     * @param agentName - Name of the executed agent
+     * @param executionTime - Time taken for execution
+     */
+    private updateExecutionStats;
+    /**
+     * Get execution statistics for monitoring
+     *
+     * @returns Map of agent execution statistics
+     */
+    getExecutionStats(): Map<string, {
+        count: number;
+        totalTime: number;
+        lastUsed: Date;
+    }>;
+    /**
+     * Get list of available agent names
+     *
+     * @private
+     * @returns Promise resolving to array of agent names
+     */
+    private getAvailableAgentsList;
+}
+export {};
+//# sourceMappingURL=RunAgentTool.d.ts.map

package/dist/tools/RunAgentTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunAgentTool.d.ts","sourceRoot":"","sources":["../../src/tools/RunAgentTool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAwB,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAItF;;GAEG;AACH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACpB,IAAI,EAAE,QAAQ,CAAA;IACd,UAAU,EAAE;QACV,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;QACpB,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ,CAAA;YACd,WAAW,EAAE,MAAM,CAAA;SACpB,CAAA;QACD,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ,CAAA;YACd,WAAW,EAAE,MAAM,CAAA;SACpB,CAAA;QACD,GAAG,EAAE;YACH,IAAI,EAAE,QAAQ,CAAA;YACd,WAAW,EAAE,MAAM,CAAA;SACpB,CAAA;QACD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO,CAAA;YACb,KAAK,EAAE;gBAAE,IAAI,EAAE,QAAQ,CAAA;aAAE,CAAA;YACzB,WAAW,EAAE,MAAM,CAAA;SACpB,CAAA;KACF,CAAA;IACD,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAYD;;;;;GAKG;AACH,qBAAa,YAAY;IAgCrB,OAAO,CAAC,aAAa,CAAC;IACtB,OAAO,CAAC,YAAY,CAAC;IAhCvB,SAAgB,IAAI,eAAc;IAClC,SAAgB,WAAW,+DAA8D;IACzF,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,cAAc,CACX;IAEX,SAAgB,WAAW,EAAE,mBAAmB,CAsB/C;gBAGS,aAAa,CAAC,EAAE,aAAa,YAAA,EAC7B,YAAY,CAAC,EAAE,YAAY,YAAA;IAOrC;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAmHxD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAuFtB;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IAwD/B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;OAIG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IAItF;;;;;OAKG;YACW,sBAAsB;CAerC"}