spotdb
Ephemeral data sandbox for AI workflows with guardrails and security
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"docker.io/aliengiraffe/spotdb": {
"args": [
"run",
"-i",
"--rm",
"docker.io/aliengiraffe/spotdb:0.1.0"
],
"command": "docker"
}
}
}可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数：query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数：urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数：url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数：url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数：input
服务介绍
SpotDB
# # Lightweight data sandbox for AI workflows and data exploration, enabled with guardrails and security to keep your data safe.
This project provides a lightweight, ephemeral data sandbox designed for large language models (LLMs) and agentic workflows. By providing a secure, isolated environment, it allows AI agents and scripts to analyze data without direct access to production databases. This setup prevents accidental data modification, ensures data privacy, and enforces guardrails for safe data exploration.
# Features
- 🏖️ Ephemeral Data Sandbox: Create temporary databases for AI workflows and data exploration.
- 📸 Snapshot: Capture and store data snapshots, recover point-in-time data states or continue from a previous state.
- 🧠 MCP API: Access data through a Model Context Protocol for seamless integration with AI models and agentic workflows.
- ⚙️ REST API: Access data through a RESTful API for integration with traditional systems and workflows.
- 🚂 Guardrails: Enforce rules and constraints to ensure data safety and privacy.
- 🛡️ Security: Protect data from unauthorized access and modification.
# Quick Start
- Tap the repository and install the package:
brew tap aliengiraffe/spaceship && \\
brew install spotdb
- Start the server:
spotdb
- Upload a CSV file:
curl -X POST \
http://localhost:8080/api/v1/upload \
-F "table_name=mytable" \
-F "has_header=true" \
-F "csv_file=@data.csv"
- Query the data:
curl -X POST \
http://localhost:8080/api/v1/query \
-H "Content-Type: application/json" \
-d '{"query": "SELECT * FROM mytable LIMIT 10"}'
- Setup Claude Code
You must have theclaudecommand installed.
Then, you can add the spotdb mcp:
claude mcp add spotdb -s user - - npx -y mcp-remote http://localhost:8081/stream
# Use Explorer UI
Open the Explorer UI in your browser and upload files and query the data:
open http://localhost:8080/explorer
