English Français العربية

ai.aliengiraffe/spotdb

السجل الرسمي الأمن

Ephemeral data sandbox for AI workflows with guardrails and security

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع ai.aliengiraffe/spotdb؟

  • 🏖️ 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

OCI package docker.io/aliengiraffe/spotdb:0.1.0
Claude Code 
claude mcp add spotdb -e 'X-API-Key=<your x-api-key>' -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "spotdb": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/aliengiraffe/spotdb:0.1.0"
            ],
            "env": {
                "X-API-Key": "<your x-api-key>"
            }
        }
    }
}

متغيرات البيئة

  • X-API-Key سري Optional API key for request authentication

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. SpotDB
  2. Features
  3. Quick Start
  4. Use Explorer UI
  5. Full Documentation

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

  1. Tap the repository and install the package:
brew tap aliengiraffe/spaceship && \\
brew install spotdb
  1. Start the server:
spotdb
  1. 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"
  1. Query the data:
curl -X POST \
  http://localhost:8080/api/v1/query \
  -H "Content-Type: application/json" \
  -d '{"query": "SELECT * FROM mytable LIMIT 10"}'
  1. Setup Claude Code You must have the claude command 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

Full Documentation

👉 https://github.com/aliengiraffe/spotdb/blob/main/DOCS.md

الأسئلة الشائعة

ما هو ai.aliengiraffe/spotdb؟

Ephemeral data sandbox for AI workflows with guardrails and security

كيف أثبّت ai.aliengiraffe/spotdb؟

يعمل على جهازك. في Claude Code: claude mcp add spotdb -e 'X-API-Key=<your x-api-key>' -- docker run -i --rm docker.io/aliengiraffe/spotdb:0.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ai.aliengiraffe/spotdb إلى مفتاح API؟

نعم. يتطلب X-API-Key، وتضبطها في إعداداته.

هل ai.aliengiraffe/spotdb مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون ai.aliengiraffe/spotdb؟

ينشره aliengiraffe. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.