RawTree MCP Server

MCP-сервер для RawTree — аналитической базы данных для неструктурированных данных. Выполняйте SQL-запросы, вставляйте JSON, просматривайте схемы таблиц, изучайте логи RawTree и управляйте учетными данными базы данных из MCP-клиентов, таких как Claude Code, Cursor и Claude Desktop.

Возможности

• Запросы — Выполнение SQL-запросов только для чтения к базе данных RawTree с получением JSON-строк, метаданных, статистики и подсказок.

• Загрузка — Вставка одного JSON-объекта, массива JSON-объектов или данных из публичного URL. Поддерживаются встроенные преобразования RawTree для OTLP-трейсов/логов/метрик, CloudWatch Logs, CloudTrail и Firehose.

• Таблицы — Просмотр списка таблиц, описание столбцов и размеров таблиц, удаление таблиц после явного подтверждения.

• Логи — Просмотр истории запросов и вставок RawTree с структурированными фильтрами по типу, статусу, источнику, таблице, подсказкам, временному окну и пагинации.

• API-ключи — Просмотр, создание и отзыв API-ключей RawTree для базы данных. При создании возвращается одноразовое значение ключа.

• Организации — Просмотр организаций, доступных аутентифицированному через OAuth пользователю.

• Базы данных — Просмотр списка баз данных в кластере и проверка доступа к выбранной базе данных.

• Кластеры — Просмотр выделенных кластеров и создание кластера после явного подтверждения. RawTree проверяет авторизацию пользователя и администратора организации.

• Транспорты — Поддержка stdio для локальных MCP-клиентов и двухрежимного Streamable HTTP для удаленных или многоклиентских развертываний, включая stateless-запросы MCP 2026-07-28 и устаревшие клиенты с рукопожатием initialize.

Related MCP server: Chakra MCP Server

Настройка

Создайте API-ключ RawTree через CLI RawTree, панель управления или API. Ключ базы данных начинается с rt_ и достаточен для таких инструментов работы с данными, как run-query, insert-json, list-tables и list-logs.

Инструмент get_database использует текущий API-ключ для чтения идентификатора базы данных из эндпоинта ключей RawTree, с запасным вариантом через эндпоинт таблиц для неадминистративных ключей базы данных с доступом только на чтение.

Использование

Сервер поддерживает два режима транспорта: stdio (по умолчанию) и HTTP.

Транспорт Stdio

Быстрая настройка

npx add-mcp @rawtree/mcp --name rawtree --env "RAWTREE_API_KEY=rt_xxxxxxxxx"

Claude Code

claude mcp add rawtree -e RAWTREE_API_KEY=rt_xxxxxxxxx -- npx -y @rawtree/mcp

Cursor

Откройте палитру команд и выберите "Cursor Settings" > "MCP" > "Add new global MCP server".

{
  "mcpServers": {
    "rawtree": {
      "command": "npx",
      "args": ["-y", "@rawtree/mcp"],
      "env": {
        "RAWTREE_API_KEY": "rt_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Откройте настройки Claude Desktop > вкладка "Developer" > "Edit Config".

{
  "mcpServers": {
    "rawtree": {
      "command": "npx",
      "args": ["-y", "@rawtree/mcp"],
      "env": {
        "RAWTREE_API_KEY": "rt_xxxxxxxxx"
      }
    }
  }
}

Транспорт HTTP

Запустите сервер через HTTP для удаленных или веб-интеграций. В режиме HTTP каждый MCP-клиент аутентифицируется, передавая свой API-ключ RawTree в заголовке Authorization.

Запустите сервер:

npx -y @rawtree/mcp --http --port 3000

Сервер слушает http://127.0.0.1:3000 и предоставляет MCP-эндпоинт по адресу /mcp через Streamable HTTP.

Claude Code

claude mcp add rawtree --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer rt_xxxxxxxxx"

Cursor

{
  "mcpServers": {
    "rawtree": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer rt_xxxxxxxxx"
      }
    }
  }
}

Вы также можете задать порт через переменную окружения MCP_PORT:

MCP_PORT=3000 npx -y @rawtree/mcp --http

Параметры

• --api-key: API-ключ базы данных RawTree для режима stdio

• --api-url: Базовый URL API RawTree, по умолчанию https://api.rawtree.com

• --database: Имя базы данных для маршрутов с областью видимости

• --org: Имя организации для маршрутов с областью видимости

• --http: Использовать HTTP-транспорт вместо stdio

• --port: HTTP-порт при использовании --http, по умолчанию 3000 или MCP_PORT

Переменные окружения:

• RAWTREE_API_KEY: API-ключ базы данных RawTree

• RAWTREE_API_URL: Базовый URL API RawTree, по умолчанию https://api.rawtree.com

• RAWTREE_DATABASE: Имя базы данных для маршрутов с областью видимости

• RAWTREE_ORG: Имя организации для маршрутов с областью видимости

• MCP_PORT: HTTP-порт при использовании --http

Инструменты

Данные

• check-health — Проверка доступности эндпоинта API RawTree.

• run-query — Выполнение SQL-запроса только для чтения и возврат JSON-ответа RawTree. Принимает переопределения организации, кластера и базы данных.

• insert-json — Вставка JSON-объекта(ов) в таблицу, опционально с преобразованием RawTree.

• insert-from-url — Загрузка данных из публичного URL и возврат потока прогресса NDJSON от RawTree.

Таблицы

• list-tables — Просмотр списка таблиц в настроенной базе данных.

• describe-table — Просмотр столбцов, количества строк, размера в байтах, базы данных и организации.

• delete-table — Удаление таблицы после явного подтверждения. Требует прав администратора.

Логи

• list-logs — Чтение логов запросов и вставок RawTree. По умолчанию за последний час, если не указано временное окно.

Структурированные фильтры логов включают:

{
  "statuses": ["error"],
  "types": ["insert"],
  "tables": ["events"],
  "origins": ["api"],
  "hints": "any",
  "limit": 50
}

API-ключи

• list-api-keys — Просмотр API-ключей для настроенной базы данных.

• create-api-key — Создание ключа с правами admin, read_write, write_only или read_only.

• delete-api-key — Отзыв ключа после явного подтверждения.

Базы данных

• list-databases — Просмотр списка баз данных в организации и кластере.

• get_database — Проверка выбранной базы данных и возврат { "name": "...", "organization": { "name": "..." } }.

Организации

• list-organizations — Просмотр организаций, доступных аутентифицированному пользователю. Требует учетных данных пользователя, например OAuth.

Кластеры

• list-clusters — Просмотр выделенных кластеров, доступных в организации.

• create-cluster — Создание выделенного кластера после явного подтверждения его организации и конфигурации оплачиваемых ресурсов.

Инструменты для работы с кластерами рекламируются каждому MCP-клиенту. API RawTree остается границей авторизации: для доступа к кластеру требуется токен доступа пользователя, а для создания кластера дополнительно требуется доступ администратора организации.

Программные хостинговые развертывания могут требовать явного выбора ресурсов для каждого применимого инструмента. Организация и кластер определяют границу ресурсов; база данных остается необязательным переопределением и по умолчанию равна default, если не указана. Это позволяет одному MCP-подключению с OAuth переключаться между организациями, кластерами и базами данных без кодирования контекста в URL MCP:

const server = createMcpServer(client, { requireExplicitScope: true });

Примеры

Запрос

{
  "organization": "acme",
  "cluster": "production",
  "database": "analytics",
  "sql": "SELECT count() AS rows FROM events"
}

Вставка JSON

{
  "table": "events",
  "data": [
    {
      "event": "signup",
      "user_id": "user_123",
      "source": "mcp"
    }
  ]
}

Вставка OTLP-трейсов

{
  "table": "traces",
  "transform": "otlp-traces",
  "data": {
    "resource": {
      "attributes": [
        {
          "key": "service.name",
          "value": {
            "stringValue": "api"
          }
        }
      ]
    },
    "scopeSpans": [
      {
        "spans": [
          {
            "name": "GET /health",
            "spanId": "abc"
          }
        ]
      }
    ]
  }
}

Отладка неудачных вставок

{
  "statuses": ["error"],
  "types": ["insert"],
  "startTime": "2026-05-28T09:00:00.000Z",
  "endTime": "2026-05-28T10:00:00.000Z",
  "limit": 25
}

Локальная разработка

1. Установка и сборка:

pnpm install
pnpm build

2. Использование локальной сборки из MCP-клиента:

claude mcp add rawtree -e RAWTREE_API_KEY=rt_xxxxxxxxx -- node /absolute/path/to/rawtree-mcp/dist/index.js

Живое тестирование с MCP-клиентом

Запустите TypeScript в режиме наблюдения, затем укажите отдельному MCP-клиенту на собранный сервер:

pnpm tsc --watch

{
  "mcpServers": {
    "rawtree-dev": {
      "command": "node",
      "args": ["/absolute/path/to/rawtree-mcp/dist/index.js"],
      "env": {
        "RAWTREE_API_KEY": "rt_xxxxxxxxx"
      }
    }
  }
}

Перезапускайте сессию MCP-клиента после каждой пересборки.

Программное использование

Корень пакета предоставляет переиспользуемый слой MCP-сервера. Node HTTP-транспорт доступен отдельно из @rawtree/mcp/http, поэтому хостинговые адаптеры могут использовать фабрику сервера без импорта локальной точки входа процесса.

import { createMcpServer, RawTreeClient } from '@rawtree/mcp';

const client = new RawTreeClient({ apiKey: process.env.RAWTREE_API_KEY! });
const server = createMcpServer(client);

Публикация

Публикация осуществляется через рабочий процесс GitHub Actions Publish.

Требуемый секрет репозитория:

• NPM_TOKEN: токен автоматизации npm с разрешением на публикацию @rawtree/mcp.

Процесс релиза:

1. Обновите package.json до новой версии.

2. Отправьте изменения в main.

3. Создайте и опубликуйте GitHub-релиз с тегом, соответствующим версии пакета, например v0.2.0.

Рабочий процесс проверяет, что тег релиза совпадает с package.json, запускает линтер, тесты и сборку, затем публикует с npm provenance:

npm publish --provenance --access public

Тестирование с MCP Inspector

Сначала соберите:

pnpm build

Запустите инспектор:

RAWTREE_API_KEY=rt_xxxxxxxxx pnpm inspector

В интерфейсе Inspector выберите stdio:

• Command: node

• Args: dist/index.js

• Environment: RAWTREE_API_KEY=rt_xxxxxxxxx

Ссылки RawTree

• Документация RawTree

• llms.txt

• Спецификация OpenAPI