← 返回目录
S

SpotDB MCP Server

社区
为 AI 工作流提供安全、临时的 SQL 沙箱
分类
数据库 第 50 / 58
Stars
★ 21 热门
传输方式
stdio(本地进程)
运行环境
预编译二进制 · Node.js
凭据
可选 API Key
许可证
MIT
最近提交
⚠
45FMRS · D

SpotDB 提供了轻量级、安全的沙箱环境,支持 MCP 和 API 双重接口,适合 AI 和数据探索场景,但需注意数据临时性。

最强项 · 安装易用性 10/20 最弱项 · 安全与权限 8/20

可靠性
9/20
安全与权限
8/20
维护活跃度
9/20
文档质量
9/20
安装易用性
10/20
查看各项评分依据
可靠性 9/20
README和清单声明了MCP API、REST API和工具能力,但未提供任何可执行的静态证据:无可见的CI工作流、无提交的测试文件、无工具清单与实现对照。快速上手示例覆盖了安装、上传、查询的happy path,但错误处理、边界情况和依赖故障的诊断路径完全缺失。按静态校准规则不高于12,考虑到happy path描述合理但验证证据为零,给9分。
安全与权限 8/20
未发现红线问题:无恶意代码迹象、无真实令牌、无可疑渗漏行为。API密钥在清单中标记为可选密钥(isSecret),HTTP认证有基本设计。但扣分明显:认证是可选的,本地服务默认可被任意客户端访问而无强制鉴权;沙箱/guardrail仅是宣传性描述,未见最小权限、危险操作确认或数据流边界披露的具体实现证据;SQL沙箱若guardrail失效可能触及底层文件系统。给8分,未达红线但安全边界证据不足。
维护活跃度 9/20
项目有MIT许可证、明确的仓库归属、非归档状态,版本v1.3.0且提供OCI包和Homebrew分发,说明有基本发布纪律。但星数低(21)、开放issue数11,issue响应速度和依赖更新节奏无法从静态材料确认,缺少SECURITY.md等安全响应渠道证据。给9分。
文档质量 9/20
README提供了安装、启动、上传、查询、Claude Code接入和Explorer UI的清晰示例,并链接到完整文档(DOCS.md)。但阅读器看到的仅是README本身:API密钥认证的使用方法、工具参数、限制、成本和故障排查均未在此展示,外部文档内容无法核验。给9分。
安装易用性 10/20
安装路径清晰:Homebrew一条命令安装、spotdb启动、curl示例验证、claude mcp add含npx mcp-remote的具体客户端配置示例,步骤少且直接。扣分点:stdio传输清单与README中HTTP/stream端点(mcp-remote http://localhost:8081/stream)存在传输方式不一致,需要用户自行判断;静态无CI+测试证据,按校准规则setup不超过15。给10分。

静态评测 · 未实际运行收录于 2026-09-08

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

  • 需要安全、隔离数据环境的 AI 开发者
  • 希望在可控环境中进行数据探索和分析的团队
  • 希望快速体验 DuckDB 功能的用户

不适合谁

  • 需要长期持久化存储的生产环境
  • 需要高并发或复杂数据管道的场景
  • 寻找完整数据库管理工具的用户

所需权限

  • 能够读取用户提供的 CSV 文件
  • 能够执行 SQL 查询(仅限沙箱内)
  • 能够通过 API 或 MCP 访问数据

风险与副作用

  • 数据在上传后可能是临时的,需及时保存
  • 沙箱可能无法直接访问生产数据库
  • 需要依赖 Docker 等外部环境

安装接入

准备工作

运行环境:预编译二进制 · Node.js

  1. 使用 Homebrew 安装并启动:brew tap aliengiraffe/spaceship && brew install spotdb,然后执行 spotdb 启动服务器。
  2. 使用 Claude Code 添加 MCP:claude mcp add spotdb -s user -- npx -y mcp-remote http://localhost:8081/stream。
  3. 上传 CSV 文件并查询数据(见文档)。

验证是否装好

先运行 spotdb 启动服务,然后在 Claude Code 中执行 `claude mcp add spotdb -s user -- npx -y mcp-remote http://localhost:8081/stream`,重启客户端后确认 SpotDB 的 MCP 工具出现在工具列表中,或访问 http://localhost:8080/explorer 确认 Explorer UI 可用。

常见排障

  1. 确保已启动 SpotDB 服务器:`spotdb`
  2. 检查端口 8080 和 8081 是否开放
  3. 确认 CSV 上传格式正确,包含表名和文件路径

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 把 data.csv 上传到 SpotDB 并命名为 mytable,然后查询前 10 行
  • 对刚上传的 CSV 运行 SELECT * FROM mytable LIMIT 10
  • 给我当前沙箱里的数据拍一个快照
  • 通过 SpotDB 用 SQL 统计 mytable 的行数

使用场景

让 AI 智能体在安全沙箱中分析数据,避免接触生产数据库
快速上传 CSV 并执行 SQL 查询以进行数据探索
作为临时数据环境集成到 MCP 或 REST 工作流中

详细介绍

SpotDB 是一款轻量级、临时性的数据沙箱,专为大型语言模型(LLM)和智能体工作流设计。它提供一个安全、隔离的环境,使 AI 智能体和脚本能够分析数据,而无需直接访问生产数据库。该设计可防止意外数据修改、确保数据隐私,并强制执行护栏以确保安全的数据探索。支持通过 MCP API 与 AI 模型无缝集成,也支持 REST API 与传统系统集成。

同类可选方案

源版本 cfbbef27f89d 数据同步于 2026-10-19 查看 FMRS 评分方法