JinDaGe - spotdb MCP Details

article

README

🚀 SpotDB

SpotDB是一个轻量级的数据沙箱，专为AI工作流和数据探索设计。它具备防护机制和安全保障，能够确保数据安全。该项目为大语言模型（LLMs）和智能体工作流提供了一个轻量级的临时数据沙箱，通过提供安全、隔离的环境，让AI智能体和脚本在不直接访问生产数据库的情况下分析数据，避免意外的数据修改，确保数据隐私，并在数据探索过程中实施安全防护。

🚀 快速开始

安装

引入仓库并安装软件包：

brew tap aliengiraffe/spaceship && \
brew install spotdb

启动服务

启动服务器：

spotdb

上传CSV文件

上传一个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 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

spotdb