logflare-mcp

Logflare管理API用のMCPサーバーです。ソース、エンドポイント、およびアドホックSQLクエリツールを、stdio経由でMCPクライアント（Claude Code、Claude Desktop、Cursorなど）に公開します。

公式の @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

設定

Logflare APIキーを https://logflare.app/access-tokens から取得してください。

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

シェルからスモークテストを実行：

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仕様に準拠）となります。レガシーな X-API-KEY ヘッダーを使用する場合は LOGFLARE_AUTH_STYLE=x-api-key を設定してください。
execute_query は bq_sql、pg_sql、ch_sql のいずれか1つのみを受け付けます。
execute_query よりも、保存されたエンドポイントを使用する query_endpoint を優先してください。保存されたエンドポイントは、Logflare側でのパラメータ検証とキャッシュが利用可能です。

ライセンス

MIT

Install Server

A

license - permissive license

A

quality

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

logflare-mcp

logflare-mcp

ツール

インストール

設定

Claude Codeへの登録

Claude Desktopへの登録

開発

注意事項

ライセンス

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API