Skip to main content
Glama
deenesjakoruzh
fasterv410

logflare-mcp

by fasterv410
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

logflare-mcp

MCP server for the Logflare Management API. Exposes sources, endpoints, and ad-hoc SQL query tools to MCP clients (Claude Code, Claude Desktop, Cursor, …) over stdio.

Built on the official @modelcontextprotocol/sdk and talks directly to the public Logflare REST API — no third-party auth proxy.

Tools

Tool

Description

list_sources

List all sources available to the API key

get_source

Fetch a single source by token

get_source_schema

Inferred field types for a source

get_recent_events

Most recent events from a source

list_endpoints

Saved query endpoints

query_endpoint

Run a saved endpoint by UUID or name, with parameters

execute_query

Run ad-hoc BigQuery / Postgres / ClickHouse SQL

Install

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

Configure

Get your Logflare API key from https://logflare.app/access-tokens.

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

Variable

Required

Default

Notes

LOGFLARE_API_KEY

yes

—

Access token

LOGFLARE_BASE_URL

no

https://logflare.app

For self-hosted Logflare

LOGFLARE_AUTH_STYLE

no

bearer

Use x-api-key for legacy keys

LOGFLARE_DEFAULT_SOURCE_TOKEN

no

—

Default source when the tool arg is omitted

Register with Claude Code

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

Or add manually to ~/.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"
      }
    }
  }
}

Register with Claude Desktop

Edit ~/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" }
    }
  }
}

Dev

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

Smoke test from the 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

Notes

  • Auth defaults to Authorization: Bearer <key> (per Logflare's OpenAPI spec). Set LOGFLARE_AUTH_STYLE=x-api-key to fall back to the legacy X-API-KEY header.

  • execute_query accepts exactly one of bq_sql, pg_sql, ch_sql.

  • Prefer query_endpoint with saved endpoints over execute_query; saved endpoints give you parameter validation and caching on Logflare's side.

License

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/fasterv410/logflare-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server