RawTree MCP Server

RawTree（非構造化データ向け分析データベース）用のMCPサーバーです。SQLによるデータクエリ、JSONの挿入、テーブルスキーマの確認、RawTreeログの確認、データベース認証情報の管理を、Claude Code、Cursor、Claude DesktopなどのMCPクライアントから実行できます。

機能

• クエリ — RawTreeデータベースに対して読み取り専用のSQLを実行し、JSON行、メタデータ、統計情報、ヒントを取得します。

• 取り込み — 単一のJSONオブジェクト、JSONオブジェクトの配列、または公開URLのデータを挿入します。OTLPトレース/ログ/メトリクス、CloudWatch Logs、CloudTrail、Firehose向けのRawTree組み込み変換をサポートします。

• テーブル — テーブルの一覧表示、テーブルのカラムとサイズの確認、明示的な確認後のテーブル削除を行います。

• ログ — タイプ、ステータス、発信元、テーブル、ヒント、時間枠、ページネーションによる構造化フィルターを使用して、RawTreeのクエリと挿入履歴を確認します。

• APIキー — データベースのRawTree APIキーを一覧表示、作成、失効させます。作成応答には一度限りのAPIキー値が含まれます。

• 組織 — OAuth認証ユーザーが利用可能な組織を一覧表示します。

• データベース — クラスター内のデータベースを一覧表示し、選択したデータベースへのアクセスを確認します。

• クラスター — 専用クラスターを一覧表示し、明示的な確認後にクラスターをプロビジョニングします。RawTreeはユーザーおよび組織管理者の認可を強制します。

• トランスポート — ローカルMCPクライアント向けのstdioと、リモートまたはマルチクライアントデプロイメント向けのデュアル時代Streamable HTTP（ステートレスMCP 2026-07-28リクエストとレガシーinitializeハンドシェイククライアントの両方を含む）をサポートします。

Related MCP server: Chakra MCP Server

セットアップ

RawTree CLI、ダッシュボード、またはAPIからRawTree APIキーを作成します。データベースAPIキーはrt_で始まり、run-query、insert-json、list-tables、list-logsなどのデータツールに十分です。

get_databaseツールは現在のAPIキーを使用して、RawTreeのキーエンドポイントからデータベースIDを読み取り、非管理者の読み取り可能なデータベースAPIキー向けにテーブルエンドポイントをフォールバックとして使用します。

使用方法

サーバーはstdio（デフォルト）とHTTPの2つのトランスポートモードをサポートします。

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トランスポート

リモートまたはWebベースの統合のために、サーバーをHTTP経由で実行します。HTTPモードでは、各MCPクライアントはAuthorizationヘッダーにRawTree APIキーを渡して認証します。

サーバーを起動します：

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

サーバーはhttp://127.0.0.1:3000でリッスンし、Streamable HTTPを使用して/mcpでMCPエンドポイントを公開します。

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：stdioモード用のRawTreeデータベースAPIキー

• --api-url：RawTree APIベースURL、デフォルトはhttps://api.rawtree.com

• --database：スコープ付きルート用のデータベース名

• --org：スコープ付きルート用の組織名

• --http：stdioの代わりにHTTPトランスポートを使用

• --port：--http使用時のHTTPポート、デフォルトは3000またはMCP_PORT

環境変数：

• RAWTREE_API_KEY：RawTreeデータベースAPIキー

• RAWTREE_API_URL：RawTree APIベースURL、デフォルトはhttps://api.rawtree.com

• RAWTREE_DATABASE：スコープ付きルート用のデータベース名

• RAWTREE_ORG：スコープ付きルート用の組織名

• MCP_PORT：--http使用時のHTTPポート

ツール

データ

• check-health — RawTree APIエンドポイントに到達可能か確認します。

• run-query — 読み取り専用のSQLを実行し、RawTreeのJSONクエリ応答を返します。組織、クラスター、データベースのオーバーライドを受け付けます。

• insert-json — JSONオブジェクトをテーブルに挿入します。オプションでRawTree変換を指定できます。

• insert-from-url — 公開URLからデータを取り込み、RawTreeのNDJSON進捗ストリームを返します。

テーブル

• list-tables — 設定されたデータベース内のテーブルを一覧表示します。

• describe-table — カラム、行数、バイト数、データベース、組織を確認します。

• delete-table — 明示的な確認後にテーブルを削除します。管理者権限が必要です。

ログ

• list-logs — RawTreeのクエリと挿入ログを読み取ります。時間枠が指定されていない場合、デフォルトで過去1時間になります。

構造化ログフィルターには以下が含まれます：

{
  "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クライアントに通知されます。RawTree APIが認可の境界となります：クラスターアクセスにはユーザーアクセストークンが必要であり、クラスター作成にはさらに組織管理者アクセスが必要です。

プログラムによるホスト型デプロイメントでは、該当するすべてのツールで明示的なリソース選択が必要になる場合があります。組織とクラスターがリソース境界を識別し、データベースはオプションのオーバーライドのままで、省略時はデフォルトでdefaultになります。これにより、1つのOAuthバックアップMCP接続が、MCP URLにコンテキストをエンコードすることなく、組織、クラスター、データベースを切り替えることができます：

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：@rawtree/mcpを公開する権限を持つnpm自動化トークン。

リリースフロー：

1. package.jsonを新しいバージョンに更新します。

2. 変更をmainにプッシュします。

3. パッケージバージョンと一致するタグ（例：v0.2.0）でGitHubリリースを作成し公開します。

ワークフローはリリースタグがpackage.jsonと一致することを確認し、lint、テスト、ビルドを実行し、npm provenanceを使用して公開します：

npm publish --provenance --access public

MCP Inspectorを使用したテスト

最初にビルド：

pnpm build

インスペクターを起動：

RAWTREE_API_KEY=rt_xxxxxxxxx pnpm inspector

インスペクターUIで、stdioを選択：

• コマンド：node

• 引数：dist/index.js

• 環境：RAWTREE_API_KEY=rt_xxxxxxxxx

RawTreeリファレンス

• RawTreeドキュメント

• llms.txt

• OpenAPI仕様