mcpField
S
spotdb

spotdb

本地服务
github.com/aliengiraffe数据库2155 周前更新
代码仓库

关于 spotdb

SpotDB 是一个轻量级、临时性的数据沙箱，面向 LLM 和 Agent 工作流。数据处于隔离环境中，AI 无需直接访问生产数据库，并内置护栏和安全控制。

主要功能

  1. 01临时数据库沙箱
  2. 02数据快照与时间点恢复
  3. 03通过 MCP API 访问数据
  4. 04通过 REST API 访问数据
  5. 05护栏规则与数据安全控制
  6. 06内置 Explorer 网页界面

适用场景

  1. 01让 AI Agent 在隔离数据上做数据分析
  2. 02在不改动生产数据的前提下探索 CSV 数据

MCP 相关

SpotDB 提供 MCP API，使 MCP 客户端（如 Claude Code）能够查询沙箱中的数据。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 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

质量门禁状态

轻量级数据沙箱，适用于 AI 工作流和数据探索，并通过防护措施和安全机制保护您的数据。

此项目提供轻量级的临时数据沙箱，专为大模型（LLM）和 Agent 工作流打造。它提供安全、隔离的环境，让 AI Agent 和脚本可以分析数据，而无需直接访问生产数据库。这种设置可防止意外修改数据，确保数据隐私，并通过防护措施保障数据探索安全。

功能

  • 🏖️ 临时数据沙箱：为 AI 工作流和数据探索创建临时数据库。
  • 📸 快照：捕获并存储数据快照，恢复某个时间点的数据状态，或从之前的状态继续操作。
  • 🧠 MCP API：通过模型上下文协议访问数据，实现与 AI 模型和 Agent 工作流的无缝集成。
  • ⚙️ 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 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。