Spotdb

🚀 SpotDB

SpotDB是一個輕量級的數據沙箱，專為AI工作流和數據探索設計。它具備防護機制和安全保障，能夠確保數據安全。該項目為大語言模型（LLMs）和智能體工作流提供了一個輕量級的臨時數據沙箱，通過提供安全、隔離的環境，讓AI智能體和腳本在不直接訪問生產數據庫的情況下分析數據，避免意外的數據修改，確保數據隱私，並在數據探索過程中實施安全防護。

🚀 快速開始

安裝

1. 引入倉庫並安裝軟件包：

brew tap aliengiraffe/spaceship && \
brew install spotdb

啟動服務

2. 啟動服務器：

spotdb

上傳CSV文件

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"}'

設置Claude Code

5. 設置Claude Code 你必須安裝了 claude 命令。然後，你可以添加 spotdb mcp：

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

使用探索器界面

打開瀏覽器中的探索器界面，上傳文件並查詢數據：

open http://localhost:8080/explorer

✨ 主要特性

• 🏖️ 臨時數據沙箱：為AI工作流和數據探索創建臨時數據庫。
• 📸 快照：捕獲並存儲數據快照，恢復特定時間點的數據狀態或從先前狀態繼續操作。
• 🧠 MCP API：通過模型上下文協議訪問數據，以便與AI模型和智能體工作流無縫集成。
• ⚙️ REST API：通過RESTful API訪問數據，以便與傳統系統和工作流集成。
• 🚂 防護機制：實施規則和約束，確保數據安全和隱私。
• 🛡️ 安全性：保護數據免受未經授權的訪問和修改。

📚 詳細文檔

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

項目質量狀態