claude-sessions-mcp

Instructions

Implementation Reference

• src/mcp/index.ts:275-304 (handler)

  The handler function for the 'stop_gui' tool. Checks if the web server instance exists, attempts a graceful shutdown via the /api/shutdown endpoint, calls stopWebServer to kill the process if necessary, and returns a success message.

  server.tool('stop_gui', 'Stop the web GUI server', {}, async () => {
    if (webServerInstance) {
      const port = webServerInstance.port
      // Call shutdown API first for graceful shutdown
      try {
        await fetch(`http://localhost:${port}/api/shutdown`, { method: 'POST' })
      } catch {
        // Server might already be stopping
      }
      // Then kill the process if still running
      await stopWebServer(webServerInstance)
      webServerInstance = null
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({ success: true, message: 'Web GUI stopped successfully' }, null, 2),
          },
        ],
      }
    }
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({ success: true, message: 'Web GUI was not running' }, null, 2),
        },
      ],
    }
  })

• src/mcp/index.ts:275-304 (registration)

  Registers the 'stop_gui' MCP tool with empty schema and the inline handler function.

  server.tool('stop_gui', 'Stop the web GUI server', {}, async () => {
    if (webServerInstance) {
      const port = webServerInstance.port
      // Call shutdown API first for graceful shutdown
      try {
        await fetch(`http://localhost:${port}/api/shutdown`, { method: 'POST' })
      } catch {
        // Server might already be stopping
      }
      // Then kill the process if still running
      await stopWebServer(webServerInstance)
      webServerInstance = null
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify({ success: true, message: 'Web GUI stopped successfully' }, null, 2),
          },
        ],
      }
    }
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify({ success: true, message: 'Web GUI was not running' }, null, 2),
        },
      ],
    }
  })

• src/server.ts:65-67 (helper)

  Supporting function called by the stop_gui handler to terminate the web server child process gracefully.

  export async function stopWebServer(server: WebServer): Promise<void> {
    server.process.kill('SIGTERM')
  }