health
Check the health status, version, and configuration of the MeshSeeks MCP server to ensure optimal performance and reliability in distributed AI agent operations.
Instructions
Returns health status, version information, and current configuration of the Claude Code MCP server.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/server.ts:409-455 (handler)The main handler logic for the 'health' tool call. It checks Claude CLI availability, collects server version, configuration, system info, and returns formatted JSON response.// Handle health check tool if (toolName === 'health') { // Check if Claude CLI is accessible let claudeCliStatus = 'unknown'; try { const { stdout } = await spawnAsync('/bin/bash', [this.claudeCliPath, '--version'], { timeout: 5000 }); claudeCliStatus = 'available'; } catch (error) { claudeCliStatus = 'unavailable'; } // Collect and return system information const healthInfo = { status: 'ok', version: this.packageVersion, claudeCli: { path: this.claudeCliPath, status: claudeCliStatus }, config: { debugMode, heartbeatIntervalMs, executionTimeoutMs, useRooModes, maxRetries, retryDelayMs }, system: { platform: os.platform(), release: os.release(), arch: os.arch(), cpus: os.cpus().length, memory: { total: Math.round(os.totalmem() / (1024 * 1024)) + 'MB', free: Math.round(os.freemem() / (1024 * 1024)) + 'MB' }, uptime: Math.round(os.uptime() / 60) + ' minutes' }, timestamp: new Date().toISOString() }; // Health check request completed, remove from tracking this.activeRequests.delete(requestId); debugLog(`[Debug] Health check request ${requestId} completed`); return { content: [{ type: 'text', text: JSON.stringify(healthInfo, null, 2) }] }; }
- src/server.ts:290-298 (registration)Registers the 'health' tool in the MCP server's listTools response, providing name, description, and input schema.{ name: 'health', description: 'Returns health status, version information, and current configuration of the Claude Code MCP server.', inputSchema: { type: 'object', properties: {}, required: [], }, },
- src/server.ts:293-297 (schema)Input schema definition for the 'health' tool, which requires no parameters (empty object).inputSchema: { type: 'object', properties: {}, required: [], },
- src/server.ts:569-570 (helper)Helper condition in the main tool dispatcher that explicitly lists 'health' as a supported tool.// Handle tools - we support 'health', 'claude_code', and 'convert_task_markdown' if (toolName !== 'claude_code' && toolName !== 'health' && toolName !== 'convert_task_markdown') {