Claude IPC MCP

Instructions

Implementation Reference

• src/claude_ipc_server.py:1162-1164 (handler)

  MCP tool handler for 'list_instances' that sends a 'list' action request to the MessageBroker via BrokerClient and returns the JSON-formatted response.

  elif name == "list_instances":
      response = BrokerClient.send_request({"action": "list"})
      return [TextContent(type="text", text=json.dumps(response, indent=2))]

• src/claude_ipc_server.py:769-774 (handler)

  Backend handler for the 'list' action in MessageBroker._process_request() that constructs and returns the list of active instances with their last_seen timestamps from the self.instances dictionary.

  elif action == "list":
      instances = [
          {"id": id, "last_seen": ts.isoformat()}
          for id, ts in self.instances.items()
      ]
      return {"status": "ok", "instances": instances}

• src/claude_ipc_server.py:985-992 (registration)

  Registration of the 'list_instances' tool in the MCP server's list_tools() function, including its description and empty input schema (no parameters required).

  Tool(
      name="list_instances",
      description="List all active Claude instances",
      inputSchema={
          "type": "object",
          "properties": {}
      }
  ),