The Aleph MCP

Instructions

Implementation Reference

• src/tools.js:262-278 (handler)

  The primary handler function that executes the tool logic: calls the client healthCheck, processes the result, and returns a formatted markdown response with status emoji.

    async healthCheck(params) {
      try {
        const result = await this.client.healthCheck();
  
        const statusEmoji = result.status === 'healthy' || result.status === 'ok' ? '✅' : '❌';
  
        return `🏥 The Aleph Health Check ${statusEmoji}
  
  **Status:** ${result.status || 'unknown'}
  **Message:** ${result.message || 'System operational'}
  
  The Aleph API is ${result.status === 'healthy' || result.status === 'ok' ? 'operational and ready' : 'experiencing issues'}.`;
  
      } catch (error) {
        return `❌ Health check failed: ${error.message}`;
      }
    }

• src/tools.js:18-26 (schema)

  The JSON schema definition for the tool, including name, description, and input schema (empty object as no parameters are required). This is returned by getToolDefinitions() for MCP tool listing.

  {
    name: 'thealeph_health_check',
    description: 'Check the health and operational status of The Aleph API',
    inputSchema: {
      type: 'object',
      properties: {},
      required: []
    }
  },

• src/tools.js:228-229 (registration)

  Registration of the tool handler in the central executeTool switch statement, dispatching calls to 'thealeph_health_check' to the healthCheck method.

  case 'thealeph_health_check':
    return this.healthCheck(params);

• src/client.js:72-74 (helper)

  Supporting API client utility that performs the actual HTTP GET request to the '/monitoring/health' endpoint, used by the tool handler.

  async healthCheck() {
    return this.makeRequest('GET', '/monitoring/health');
  }

• src/server.js:49-53 (registration)

  MCP protocol registration for tool listing (ListToolsRequest), which provides the tool schema/definitions including 'thealeph_health_check' to MCP clients.

  this.server.setRequestHandler(this.mcpSDK.ListToolsRequestSchema, async () => {
    return {
      tools: this.tools.getToolDefinitions(),
    };
  });