Visum Thinker MCP Server

Instructions

Implementation Reference

• src/index-backup.ts:662-711 (registration)

  MCP tool registration for 'visum_network_stats'. Defines empty schema and thin handler that delegates to PersistentVisumController.getNetworkStats() and formats the markdown response.

  server.tool(
    "visum_network_stats",
    "Get comprehensive network statistics from the loaded Visum project",
    {},
    async () => {
      try {
        const result = await visumController.getNetworkStats();
        
        if (result.success) {
          return {
            content: [
              {
                type: "text",
                text: `✅ **Statistiche Rete PERSISTENTE**\n\n` +
                      `**Riepilogo Rete:**\n` +
                      `• **Nodi:** ${result.result?.nodes?.toLocaleString() || 'N/A'}\n` +
                      `• **Link:** ${result.result?.links?.toLocaleString() || 'N/A'}\n` +
                      `• **Zone:** ${result.result?.zones?.toLocaleString() || 'N/A'}\n\n` +
                      `**Performance ULTRA-VELOCE:**\n` +
                      `• **Tempo Query:** ${result.result?.query_time_ms?.toFixed(3) || 'N/A'}ms\n` +
                      `• **Tempo Totale:** ${result.executionTimeMs?.toFixed(3) || 'N/A'}ms\n` +
                      `• **Persistente:** ${result.result?.persistent ? '✅ SÌ' : '❌ NO'}\n\n` +
                      `*Dati recuperati da istanza VisumPy PERSISTENTE - Ultra-veloce!*`
              }
            ]
          };
        } else {
          return {
            content: [
              {
                type: "text",
                text: `❌ **Impossibile ottenere statistiche rete**\n\n` +
                      `Il progetto Visum potrebbe non essere caricato o accessibile.\n` +
                      `La prima chiamata potrebbe richiedere più tempo per inizializzare l'istanza VisumPy.`
              }
            ]
          };
        }
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `❌ **Errore ottenimento statistiche rete:**\n\n${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

• src/persistent-visum-controller.ts:978-996 (handler)

  Core handler method in PersistentVisumController that sends optimized Python code to the persistent VisumPy process to query network counts (nodes, links, zones) and measures execution time.

    public async getNetworkStats(): Promise<VisumResponse> {
      const code = `
  # Ultra-fast network statistics from persistent instance
  start_time = time.time()
  nodes = visum.Net.Nodes.Count
  links = visum.Net.Links.Count
  zones = visum.Net.Zones.Count
  elapsed = time.time() - start_time
  
  result = {
      'nodes': nodes,
      'links': links, 
      'zones': zones,
      'query_time_ms': round(elapsed * 1000, 3),
      'persistent': True
  }
  `;
      return this.sendCommandToPersistentProcess(code, "Network statistics (persistent)");
    }

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

  Empty input schema (no parameters required).

  {},

• test-mcp-simulation.py:138-158 (helper)

  Test simulation of the tool call, demonstrating the network stats Python code execution.

      # TOOL 1: visum_network_stats
      result1 = simulate_mcp_tool_call(
          "visum_network_stats",
          """
  # Basic network statistics
  nodes = visum.Net.Nodes.Count
  links = visum.Net.Links.Count
  zones = visum.Net.Zones.Count
  
  result['network_stats'] = {
      'nodes': nodes,
      'links': links,
      'zones': zones,
      'timestamp': time.time()
  }
  
  print(f"Network stats: {nodes:,} nodes, {links:,} links, {zones:,} zones")
  """,
          "Get basic network statistics"
      )
      all_results.append(result1)