logflare-mcp

用于 Logflare 管理 API 的 MCP 服务器。通过 stdio 向 MCP 客户端（如 Claude Code、Claude Desktop、Cursor 等）公开源、端点和即席 SQL 查询工具。

基于官方 @modelcontextprotocol/sdk 构建，并直接与公共 Logflare REST API 通信 — 无需第三方身份验证代理。

工具

工具	描述
`list_sources`	列出 API 密钥可访问的所有源
`get_source`	通过令牌获取单个源
`get_source_schema`	推断源的字段类型
`get_recent_events`	获取源中最近的事件
`list_endpoints`	已保存的查询端点
`query_endpoint`	通过 UUID 或名称运行已保存的端点，并带有参数
`execute_query`	运行即席 BigQuery / Postgres / ClickHouse SQL

安装

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

配置

从 https://logflare.app/access-tokens 获取您的 Logflare API 密钥。

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

变量	必需	默认值	说明
`LOGFLARE_API_KEY`	是	—	访问令牌
`LOGFLARE_BASE_URL`	否	`https://logflare.app`	用于自托管 Logflare
`LOGFLARE_AUTH_STYLE`	否	`bearer`	旧版密钥请使用 `x-api-key`
`LOGFLARE_DEFAULT_SOURCE_TOKEN`	否	—	省略工具参数时的默认源

在 Claude Code 中注册

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

或手动添加到 ~/.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"
      }
    }
  }
}

在 Claude Desktop 中注册

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

开发

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

从 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

注意事项

身份验证默认为 Authorization: Bearer <key>（根据 Logflare 的 OpenAPI 规范）。设置 LOGFLARE_AUTH_STYLE=x-api-key 以回退到旧版 X-API-KEY 请求头。
execute_query 仅接受 bq_sql、pg_sql、ch_sql 中的一个。
优先使用 query_endpoint 和已保存的端点，而不是 execute_query；已保存的端点在 Logflare 端提供参数验证和缓存。