Kibana MCP Server

Instructions

Implementation Reference

• src/base-tools.ts:139-163 (handler)

  The asynchronous handler function that executes the tool logic: fetches Kibana server status via kibanaClient.get('/api/status'), formats the response with space context, handles errors gracefully.

  async ({ space }): Promise<ToolResponse> => {
    try {
      const targetSpace = space || defaultSpace;
      const response = await kibanaClient.get('/api/status', { space });
      return {
        content: [
          {
            type: "text",
            text: `[Space: ${targetSpace}] Kibana server status: ${JSON.stringify(response, null, 2)}`
          }
        ]
      };
    } catch (error) {
      console.error(`Failed to get server status: ${error}`);
      return {
        content: [
          {
            type: "text",
            text: `Error: ${error instanceof Error ? error.message : String(error)}`
          }
        ],
        isError: true
      };
    }
  }

• src/base-tools.ts:136-138 (schema)

  Zod input schema defining an optional 'space' parameter for targeting specific Kibana spaces.

  z.object({
    space: z.string().optional().describe("Target Kibana space (optional, defaults to configured space)")
  }),

• src/base-tools.ts:134-164 (registration)

  Tool registration using server.tool(), including name, description, schema, and handler function.

    "get_status",
    `Get Kibana server status with multi-space support`,
    z.object({
      space: z.string().optional().describe("Target Kibana space (optional, defaults to configured space)")
    }),
    async ({ space }): Promise<ToolResponse> => {
      try {
        const targetSpace = space || defaultSpace;
        const response = await kibanaClient.get('/api/status', { space });
        return {
          content: [
            {
              type: "text",
              text: `[Space: ${targetSpace}] Kibana server status: ${JSON.stringify(response, null, 2)}`
            }
          ]
        };
      } catch (error) {
        console.error(`Failed to get server status: ${error}`);
        return {
          content: [
            {
              type: "text",
              text: `Error: ${error instanceof Error ? error.message : String(error)}`
            }
          ],
          isError: true
        };
      }
    }
  );