logflare-mcp

Servidor MCP para la API de gestión de Logflare. Expone fuentes, endpoints y herramientas de consulta SQL ad-hoc a clientes MCP (Claude Code, Claude Desktop, Cursor, …) a través de stdio.

Construido sobre el @modelcontextprotocol/sdk oficial y se comunica directamente con la API REST pública de Logflare, sin proxies de autenticación de terceros.

Herramientas

Instalación

git clone git@github.com:fasterv410/logflare-mcp.git
cd logflare-mcp
pnpm install
pnpm build

Configuración

Obtenga su clave API de Logflare en https://logflare.app/access-tokens.

cp .env.example .env
# edit .env and paste your key

Registrar con Claude Code

claude mcp add logflare -- node /absolute/path/to/logflare-mcp/dist/index.js

O añádalo manualmente a ~/.claude.json:

{
  "mcpServers": {
    "logflare": {
      "command": "node",
      "args": ["/absolute/path/to/logflare-mcp/dist/index.js"],
      "env": {
        "LOGFLARE_API_KEY": "lf-xxxxxxxx",
        "LOGFLARE_DEFAULT_SOURCE_TOKEN": "optional-uuid"
      }
    }
  }
}

Registrar con Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "logflare": {
      "command": "node",
      "args": ["/absolute/path/to/logflare-mcp/dist/index.js"],
      "env": { "LOGFLARE_API_KEY": "lf-xxxxxxxx" }
    }
  }
}

Desarrollo

pnpm dev         # tsx watch mode
pnpm build       # emit dist/
pnpm typecheck

Prueba de humo desde el shell:

LOGFLARE_API_KEY=xxx printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | node dist/index.js

Notas

• La autenticación utiliza por defecto Authorization: Bearer <key> (según la especificación OpenAPI de Logflare). Establezca LOGFLARE_AUTH_STYLE=x-api-key para volver al encabezado heredado X-API-KEY.

• execute_query acepta exactamente uno de bq_sql, pg_sql, ch_sql.

• Prefiera query_endpoint con endpoints guardados en lugar de execute_query; los endpoints guardados le ofrecen validación de parámetros y almacenamiento en caché del lado de Logflare.

Licencia

MIT