Orchestrator MCP

Instructions

Implementation Reference

• src/server/handlers/orchestrator.ts:16-57 (handler)

  The handler function that implements the core logic for the 'get_info' tool. It gathers server information, counts connected servers and tools, and returns formatted server capabilities.

  export async function handleGetInfo(orchestrator: OrchestratorManager) {
    try {
      const serverInfo = await orchestrator.getServerInfo();
      const connectedServers = Object.keys(serverInfo.servers).length;
      const totalTools = await orchestrator.getAllTools();
      
      const info = {
        name: 'Orchestrator MCP Server',
        version: '1.0.0',
        description: 'AI-enhanced MCP server orchestrator',
        connectedServers,
        totalTools: totalTools.length,
        servers: serverInfo.servers,
        capabilities: [
          'Multi-server orchestration',
          'AI-powered tool selection',
          'Intelligent workflow execution',
          'Tool usage tracking',
          'Intelligence layer analysis',
        ],
      };
      
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(info, null, 2),
          },
        ],
      };
    } catch (error) {
      logger.error('Failed to get server info:', error as Error);
      return {
        content: [
          {
            type: 'text',
            text: `Error getting server info: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }
  }

• src/server/handlers/dispatcher.ts:24-57 (registration)

  The dispatcher function that registers the tool call handler and routes 'get_info' calls to the handleGetInfo function.

  export function setupToolCallHandler(
    server: Server,
    orchestrator: OrchestratorManager,
    aiOrchestrator: AIOrchestrator
  ): void {
    server.setRequestHandler(CallToolRequestSchema, async (request) => {
      const { name, arguments: args } = request.params;
      
      try {
        logger.info(`Handling tool call: ${name}`);
        
        // Route to streamlined tool handlers
        switch (name) {
          case 'ai_process':
            return handleAIProcess(args, aiOrchestrator);
  
          case 'get_info':
            return handleGetInfo(orchestrator);
  
          case 'ai_status':
            return handleAIStatus(aiOrchestrator);
  
          // Context engine tools removed
  
          default:
            // Try to delegate to connected servers
            return await orchestrator.callTool(name, args);
        }
      } catch (error) {
        logger.error(`Error handling tool call ${name}:`, error as Error);
        return createErrorResponse(error as Error);
      }
    });
  }

• src/server/handlers/tools.ts:38-47 (schema)

  The schema definition for the 'get_info' tool provided in the listTools response, including name, description, and empty input schema.

  {
    name: 'get_info',
    description: 'System introspection - discover available capabilities, connected servers, and tool inventory. Use this to understand what the orchestrator can do before making complex requests.',
    inputSchema: {
      type: 'object',
      properties: {},
      additionalProperties: false,
      $schema: 'http://json-schema.org/draft-07/schema#',
    },
  },