{
  "markdown": "# SpotDB\n\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=aliengiraffe_env&metric=alert_status&token=a564584b18c4d708580b4825a1d8c270b18a3f3f)](https://sonarcloud.io/summary/new_code?id=aliengiraffe_env)\n\n### Lightweight data sandbox for AI workflows and data exploration, enabled with guardrails and security to keep your data safe.\n\nThis 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.\n\n## Features\n\n- 🏖️ **Ephemeral Data Sandbox**: Create temporary databases for AI workflows and data exploration.\n- 📸 **Snapshot**: Capture and store data snapshots, recover point-in-time data states or continue from a previous state.\n- 🧠 **MCP API**: Access data through a Model Context Protocol for seamless integration with AI models and agentic workflows.\n- ⚙️ **REST API**: Access data through a RESTful API for integration with traditional systems and workflows.\n- 🚂 **Guardrails**: Enforce rules and constraints to ensure data safety and privacy.\n- 🛡️ **Security**: Protect data from unauthorized access and modification.\n\n## Quick Start\n\n1. Tap the repository and install the package:\n\n```bash\nbrew tap aliengiraffe/spaceship && \\\\\nbrew install spotdb\n```\n\n2. Start the server:\n\n```bash\nspotdb\n```\n\n3. Upload a CSV file:\n\n```bash\ncurl -X POST \\\n  http://localhost:8080/api/v1/upload \\\n  -F \"table_name=mytable\" \\\n  -F \"has_header=true\" \\\n  -F \"csv_file=@data.csv\"\n```\n\n4. Query the data:\n\n```bash\ncurl -X POST \\\n  http://localhost:8080/api/v1/query \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\": \"SELECT * FROM mytable LIMIT 10\"}'\n```\n\n5. Setup Claude Code\n   You must have the `claude` command installed.\n\nThen, you can add the `spotdb` mcp:\n\n```bash\nclaude mcp add spotdb -s user -- npx -y mcp-remote http://localhost:8081/stream\n```\n\n## Use Explorer UI\n\nOpen the Explorer UI in your browser and upload files and query the data:\n\n```bash\nopen http://localhost:8080/explorer\n```\n\n## Full Documentation\n\n👉 [https://github.com/aliengiraffe/spotdb/blob/main/DOCS.md](https://github.com/aliengiraffe/spotdb/blob/main/DOCS.md)\n",
  "bytes": 2407,
  "sha": "28e5b3326337463be6b091257a0770fee6ad92ff87565962cd611affe3c6fd6f",
  "repo_slug": "aliengiraffe/spotdb",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_aliengiraffe_spotdb_ccb45f8f/readme"
}