Spotdb

🚀 SpotDB

AIワークフローとデータ探索のための軽量データサンドボックスで、ガードレールとセキュリティ機能を備え、データを安全に保ちます。

🚀 クイックスタート

1. リポジトリを追加し、パッケージをインストールします。

brew tap aliengiraffe/spaceship && \
brew install spotdb

2. サーバーを起動します。

spotdb

3. CSVファイルをアップロードします。

curl -X POST \
  http://localhost:8080/api/v1/upload \
  -F "table_name=mytable" \
  -F "has_header=true" \
  -F "csv_file=@data.csv"

4. データをクエリします。

curl -X POST \
  http://localhost:8080/api/v1/query \
  -H "Content-Type: application/json" \
  -d '{"query": "SELECT * FROM mytable LIMIT 10"}'

5. Claude Codeをセットアップします。 claude コマンドがインストールされている必要があります。 その後、spotdb のMCPを追加できます。

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

✨ 主な機能

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

💻 使用例

基本的な使用法

パッケージのインストール

brew tap aliengiraffe/spaceship && \
brew install spotdb

サーバーの起動

spotdb

CSVファイルのアップロード

curl -X POST \
  http://localhost:8080/api/v1/upload \
  -F "table_name=mytable" \
  -F "has_header=true" \
  -F "csv_file=@data.csv"

データのクエリ

curl -X POST \
  http://localhost:8080/api/v1/query \
  -H "Content-Type: application/json" \
  -d '{"query": "SELECT * FROM mytable LIMIT 10"}'

Claude Codeのセットアップ

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

高度な使用法

Explorer UIの使用

open http://localhost:8080/explorer

📚 ドキュメント

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