Visum Thinker MCP Server

Instructions

Implementation Reference

• src/index-backup.ts:783-823 (registration)

  MCP server tool registration for 'project_start_instance', including input schema and handler function that invokes projectManager.startProjectInstance and formats the response content.

  server.tool(
    "project_start_instance",
    "Start dedicated persistent instance for specific Visum project",
    {
      projectId: z.string().describe("Project identifier (campoleone, testProject, etc.)")
    },
    async ({ projectId }) => {
      try {
        const result = await projectManager.startProjectInstance(projectId);
        
        if (result.success) {
          return {
            content: [
              {
                type: "text",
                text: `🚀 **Istanza Progetto Avviata**\n\n✅ ${result.message}\n\n📊 **Network Stats:**\n- Nodi: ${result.stats?.nodes}\n- Link: ${result.stats?.links}\n- Zone: ${result.stats?.zones}\n\n🔄 L'istanza è ora attiva e pronta per ricevere comandi.`
              }
            ]
          };
        } else {
          return {
            content: [
              {
                type: "text",
                text: `❌ **Errore Avvio Istanza**\n\n${result.message}`
              }
            ]
          };
        }
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `❌ **Errore:** ${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

• src/index-backup.ts:786-788 (schema)

  Zod schema for the tool input parameter 'projectId'.

  {
    projectId: z.string().describe("Project identifier (campoleone, testProject, etc.)")
  },

• src/project-instance-manager.ts:61-133 (handler)

  Core implementation of startProjectInstance method in ProjectInstanceManager, called by the tool handler. Handles project config lookup, instance creation, Visum process startup via PersistentVisumController, and stores the active instance.

  public async startProjectInstance(projectId: string): Promise<{
    success: boolean;
    message: string;
    stats?: any;
  }> {
    console.error(`🚀 Starting persistent instance for project: ${projectId}`);
  
    const config = this.PROJECT_CONFIGS[projectId];
    if (!config) {
      return {
        success: false,
        message: `Unknown project ID: ${projectId}. Available: ${Object.keys(this.PROJECT_CONFIGS).join(', ')}`
      };
    }
  
    // Verifica se l'istanza è già attiva
    if (this.projectInstances.has(projectId)) {
      const existing = this.projectInstances.get(projectId)!;
      if (existing.isActive) {
        return {
          success: true,
          message: `Project ${config.name} instance already running`,
          stats: existing.stats
        };
      }
    }
  
    try {
      const startTime = Date.now();
      
      // Crea controller personalizzato per questo progetto
      const controller = new PersistentVisumController(config.projectPath);
      
      const result = await controller.startPersistentVisumProcess();
      
      if (result.success) {
        const projectInstance: ProjectInstance = {
          config,
          controller,
          isActive: true,
          startTime,
          lastUsed: Date.now(),
          stats: {
            nodes: result.nodes || 0,
            links: result.links || 0,
            zones: result.zones || 0
          }
        };
  
        this.projectInstances.set(projectId, projectInstance);
  
        console.error(`✅ Project ${config.name} instance started successfully`);
        console.error(`   📊 Network: ${result.nodes} nodes, ${result.links} links, ${result.zones} zones`);
        console.error(`   ⏱️ Startup time: ${Date.now() - startTime}ms`);
  
        return {
          success: true,
          message: `Persistent instance for ${config.name} started successfully`,
          stats: projectInstance.stats
        };
      } else {
        return {
          success: false,
          message: `Failed to start ${config.name}: ${result.message}`
        };
      }
    } catch (error) {
      return {
        success: false,
        message: `Error starting ${config.name}: ${error instanceof Error ? error.message : String(error)}`
      };
    }
  }

• src/index-backup.ts:23-24 (helper)

  Initialization of projectManager singleton instance used by the tool handler.

  const projectManager = ProjectInstanceManager.getInstance(); // Project-specific instances
  const serverManager = ProjectServerManager.getInstance(); // TCP server manager

• src/index-backup.ts:13-13 (helper)

  Import of ProjectInstanceManager class.

  import { ProjectInstanceManager } from "./project-instance-manager.js";