logflare-mcp

MCP-сервер для Management API Logflare. Предоставляет MCP-клиентам (Claude Code, Claude Desktop, Cursor и др.) инструменты для работы с источниками, эндпоинтами и произвольными SQL-запросами через stdio.

Построен на базе официального @modelcontextprotocol/sdk и взаимодействует напрямую с публичным REST API Logflare — без сторонних прокси-серверов аутентификации.

Инструменты

Установка

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

Настройка

Получите ваш API-ключ Logflare на странице https://logflare.app/access-tokens.

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

Регистрация в 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> (согласно спецификации OpenAPI Logflare). Установите LOGFLARE_AUTH_STYLE=x-api-key для использования устаревшего заголовка X-API-KEY.

• execute_query принимает ровно один из параметров: bq_sql, pg_sql, ch_sql.

• Отдавайте предпочтение query_endpoint с сохраненными эндпоинтами вместо execute_query; сохраненные эндпоинты обеспечивают проверку параметров и кэширование на стороне Logflare.

Лицензия

MIT