mcpField
S
spotdb

spotdb

ローカル
github.com/aliengiraffeデータベース2155 週間前に更新
リポジトリ

spotdb について

SpotDB は、LLM や エージェント ワークフロー向けの軽量で一時的なデータサンドボックスです。データを隔離された環境に置くことで、本番データベースに直接アクセスせずにAI エージェントがデータを分析できます。ガードレールとセキュリティ機能を備えています。

主な機能

  1. 01一時的なデータベースサンドボックス
  2. 02データのスナップショットと時点への復元
  3. 03MCP API によるデータアクセス
  4. 04REST API による従来システムとの連携
  5. 05データ制約を適用するガードレール
  6. 06ブラウザで使える Explorer UI

活用シーン

  1. 01隔離された環境での AI エージェントによるデータ分析
  2. 02本番データに影響を与えずに CSV データを調査

MCP 対応

SpotDB は MCP API を提供し、Claude Code などの MCP クライアントからサンドボックス内のデータを照会できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "ai-aliengiraffe-spotdb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "X-API-Key",
        "docker.io/aliengiraffe/spotdb:0.1.0"
      ],
      "env": {
        "X-API-Key": "<X-API-Key>"
      }
    }
  }
}
起動コマンドdocker run -i --rm -e X-API-Key docker.io/aliengiraffe/spotdb:0.1.0
設定が必要な環境変数
X-API-KeyシークレットOptional API key for request authentication

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocidocker.io/aliengiraffe/spotdb:0.1.0

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

SpotDB

Quality Gate Status

ガードレールとセキュリティでデータを保護する、AI ワークフローとデータ探索のための軽量なデータサンドボックスです。

このプロジェクトは、LLM とエージェント型ワークフロー向けに設計された、軽量な一時的データサンドボックスを提供します。安全で隔離された環境を提供することで、AI エージェントやスクリプトが本番データベースに直接アクセスすることなくデータを分析できます。この構成により、意図しないデータの変更を防ぎ、データのプライバシーを確保し、安全なデータ探索のためのガードレールを適用します。

機能

  • 🏖️ 一時的なデータサンドボックス：AI ワークフローやデータ探索のための一時的なデータベースを作成します。
  • 📸 スナップショット：データのスナップショットを取得して保存し、特定時点のデータ状態を復元したり、以前の状態から続けたりできます。
  • 🧠 MCP API：Model Context Protocol を通じてデータにアクセスし、AI モデルやエージェント型ワークフローとシームレスに統合できます。
  • ⚙️ REST API：RESTful API を通じてデータにアクセスし、従来のシステムやワークフローと統合できます。
  • 🚂 ガードレール：データの安全性とプライバシーを確保するために、ルールと制約を適用します。
  • 🛡️ セキュリティ：不正なアクセスや変更からデータを保護します。

クイックスタート

  1. リポジトリをクローンしてパッケージをインストールします。
brew tap aliengiraffe/spaceship && \\
brew install spotdb
  1. サーバーを起動します。
spotdb
  1. CSV ファイルをアップロードします。
curl -X POST \
  http://localhost:8080/api/v1/upload \
  -F "table_name=mytable" \
  -F "has_header=true" \
  -F "[email protected]"
  1. データをクエリします。
curl -X POST \
  http://localhost:8080/api/v1/query \
  -H "Content-Type: application/json" \
  -d '{"query": "SELECT * FROM mytable LIMIT 10"}'
  1. Claude Code をセットアップします。 claude コマンドがインストールされている必要があります。

次に、spotdb MCP を追加します。

claude mcp add spotdb -s user -- npx -y mcp-remote http://localhost:8081/stream

Explorer UI を使用する

ブラウザーで Explorer UI を開き、ファイルをアップロードしてデータをクエリします。

open http://localhost:8080/explorer

詳細なドキュメント

👉 https://github.com/aliengiraffe/spotdb/blob/main/DOCS.md

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。