io.datanika/datanika-mcp

السجل الرسمي أخرى

Read-only-by-default MCP for Datanika: browse data, run dbt transforms, manage ELT pipelines.

التثبيت

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

PYPI package datanika-mcp
Claude Code
claude mcp add datanika-mcp -e 'DATANIKA_URL=<DATANIKA_URL>' -e 'DATANIKA_API_KEY=<your datanika_api_key>' -e 'DATANIKA_ALLOW_WRITE=<DATANIKA_ALLOW_WRITE>' -- uvx datanika-mcp==0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "datanika-mcp": {
            "command": "uvx",
            "args": [
                "datanika-mcp==0.2.0"
            ],
            "env": {
                "DATANIKA_URL": "<DATANIKA_URL>",
                "DATANIKA_API_KEY": "<your datanika_api_key>",
                "DATANIKA_ALLOW_WRITE": "<DATANIKA_ALLOW_WRITE>"
            }
        }
    }
}

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

  • DATANIKA_URL Datanika instance URL (defaults to https://app.datanika.io; set this for a self-hosted instance)
  • DATANIKA_API_KEY إلزامي سري Datanika API key (from Settings -> API Keys)
  • DATANIKA_ALLOW_WRITE Set to true to enable write/trigger tools (read-only by default)

التوثيق

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

المحتويات
  1. Datanika
  2. Features
  3. Quick Start
  4. Releases & versioning
  5. Why Datanika?
  6. Tech Stack
  7. Roadmap
  8. AI Agent Integration
  9. Open-Core Strategy
  10. Links
  11. Security
  12. Contributing
  13. License

Datanika

Open-source data pipeline platform — Extract, Load, Transform, and Orchestrate from a single UI.

Datanika combines dlt (extract + load) with dbt-core (transform) and adds visual pipeline management, scheduling, and monitoring — all in one Python-native platform.

Think Airbyte + dbt Cloud + Airflow — in one tool, self-hostable with Docker Compose.


Features

🔌 36 Connectors — PostgreSQL, MySQL, Oracle, MongoDB, BigQuery, Snowflake, Stripe, HubSpot, Salesforce, Kafka, ClickHouse, and more 🔄 dbt Transformations — SQL models, tests, snapshots, packages, and source freshness built in 📊 Visual Pipeline Builder — DAG editor with dependency management ⏰ Scheduling — Cron-based with APScheduler, persistent across restarts 📈 Monitoring — Run history, streaming logs, and dashboard stats 🔐 Enterprise Security — RBAC, SSO (SAML/OIDC), audit logging, encrypted credentials 🌍 9 Languages — English, German, French, Spanish, Russian, Greek, Chinese, Arabic, Serbian 🔌 REST API — Full CRUD with OpenAPI/Swagger docs, rate limiting, and scoped API keys 🤖 AI-Agent Ready — hosted + local MCP server (25 tools), /llms.txt, agent-guide.md, 5-tier capability API, compile+preview validation, typed error codes, ?wait=true, Idempotency-Key, run cancellation 🚀 Pipeline Templates — One-click starter templates (Stripe→Postgres, Postgres→BigQuery, CSV→DuckDB) with prefilled connection configs 🔔 Notifications — Slack, Telegram, email, and webhook alerts on run completion, plus an in-app notification center 📦 Self-Hostable — Single docker compose up — no Kubernetes required


Quick Start

git clone https://github.com/datanika-io/datanika-core.git
cd datanika-core
cp .env.example .env
# Edit .env with your settings
docker compose up -d

App available at http://localhost:3000

Development
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
docker compose up -d postgres redis  # infrastructure only
uv run reflex run                     # starts on :3000 + :8000

Releases & versioning

Datanika uses 0.x SemVer with tagged releases (v0.1.0, …). While pre-1.0, breaking changes bump the minor. There is no 1.0 yet — that will mean a committed, stable public API contract.

Self-hosting? Pin a release instead of tracking master. master is continuously deployed to our hosted app and moves several times a day.

git checkout v0.1.0            # source
docker compose up -d --build   # build the image from that source

⚠️ There is no publicly pullable image yet. ghcr.io/datanika-io/datanika-core exists but is private, so docker pull on any tag answers denied for everyone outside the org — this README told you otherwise until 2026-09-03. It stays private on purpose: the image grafts in our closed-source cloud plugin, so publishing it as built today would publish that too. Pin the source tag and build; that path is exercised by CI.

Building it yourself gives you the same artifact we would publish. Since 2026-09-04 the Dockerfile carries a DATANIKA_IMAGE_EDITION build arg, and the core-only variant is built and asserted on every PR (core-only-image in CI) from a context that does not contain the cloud tree at all — which is the context you have.

⚠️ The Dockerfile expects a monorepo-shaped context: it does COPY datanika/pyproject.toml, so the build context is the parent directory and this checkout has to be the datanika/ inside it. Clone it under that name and build from one level up:

git clone https://github.com/datanika-io/datanika-core.git datanika
docker build --build-arg DATANIKA_IMAGE_EDITION=core -f datanika/Dockerfile .

The resulting image carries no /cloud tree and cannot import datanika_cloud. Leave DATANIKA_EDITION unset — its default is core. Setting it to cloud on this image fails immediately and loudly (ModuleNotFoundError: No module named 'datanika_cloud'), which is deliberate: the alternative is a service that looks healthy and enforces nothing. Publishing this under a public GHCR package is tracked in #1014.

Every version's notes are on the Releases page. Security advisories cite the first patched release (e.g. Patched: v0.1.0), so a pinned tag tells you immediately whether you're affected.

The datanika-mcp sub-package is versioned and released independently (mcp-v* tags, published to PyPI).


Why Datanika?

DatanikaAirbyteFivetrandbt Cloud
Extract + Load✅ 36 connectors✅ 600+ [^1]✅ 700+ [^1]❌
Transformations✅ dbt built-in❌❌ (add-on)✅
Scheduling✅ Cron + DAG✅ Basic✅ Basic✅
Pipeline DAG✅ Visual❌❌❌
Self-host✅ Docker⚠️ Needs K8s❌ SaaS only❌ SaaS only
Open source✅ AGPL-3.0⚠️ ELv2❌❌
Notifications✅ Slack/Telegram/Email/Webhook✅✅✅
PricingFree foreverFree tier limited~$250+/mo~$100+/mo

[^1]: Competitor connector counts as published by each vendor's own connector directory, checked 2026-08-30. Ours is derived from ConnectionType in code, not written by hand. We do not track other vendors' catalogues continuously — if this footnote's date looks old, check the source rather than trusting the number.


Tech Stack

ComponentTechnology
FrontendReflex (Python → React)
BackendStarlette (via Reflex)
Extract + Loaddlt
Transformdbt-core
DatabasePostgreSQL 16
Task QueueCelery + Redis
SchedulingAPScheduler

Roadmap

  • [x] 36 connectors (databases, SaaS APIs, files, streaming)
  • [x] dbt transformations, tests, snapshots, packages
  • [x] REST API v1 with OpenAPI/Swagger and typed per-connector inline schemas
  • [x] AI-agent compatibility (/llms.txt, agent-guide, 5-tier API, golden-path loop, ?wait=true, Idempotency-Key, run cancel, MCP server)
  • [x] Pipeline templates (one-click setup)
  • [x] In-app notification center with Slack, Telegram, Email, Webhook channels
  • [x] SSO (SAML/OIDC) for Enterprise
  • [x] Usage-based billing (cloud plugin)
  • [x] 2,300+ tests across unit, security, and E2E (SQLite in-memory for speed)
  • [x] Kubernetes Helm chart — in-tree at deploy/helm/datanika/; installs the same image as the Compose path. Bundled Postgres/Redis are single-replica and not production-grade — point it at managed databases (see the chart README)
  • [ ] Data lineage visualization

AI Agent Integration

Datanika speaks MCP, so AI agents (Claude Desktop, Claude Code, Cursor, …) can browse connections, preview data, compile transformations, and monitor runs natively. 25 tools — 17 read-only, 8 write. There are two ways in.

Hosted — nothing to install. Paste this wherever your client accepts a remote MCP server and authorize in the browser:

https://app.datanika.io/mcp

OAuth 2.1, no API key to handle. Read-only unless you grant write at consent — a client that asks for nothing gets read-only, and a pasted API key stays read-only here even if its own scopes allow writes.

Local — stdio. Published on PyPI as datanika-mcp and listed on the official MCP registry as io.datanika/datanika-mcp:

# read-only by default; add --allow-write to enable the 8 write tools
uvx datanika-mcp --url https://app.datanika.io --api-key YOUR_KEY

See datanika-mcp/README.md for per-client config snippets and the full tool list, or datanika.io/docs/mcp-server for the hosted walkthrough.

Additional agent resources:


Open-Core Strategy

Core platform is open-source (AGPL-3.0). Cloud version adds billing, quotas, and usage metering via the datanika-cloud plugin.



Security

Found a vulnerability? See SECURITY.md for our disclosure policy, supported versions, and reporting instructions.


Contributing

We welcome contributors and design partners. Open an issue or contact info@datanika.io.


License

AGPL-3.0

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

ما هو io.datanika/datanika-mcp؟

Read-only-by-default MCP for Datanika: browse data, run dbt transforms, manage ELT pipelines.

كيف أثبّت io.datanika/datanika-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add datanika-mcp -e 'DATANIKA_URL=<DATANIKA_URL>' -e 'DATANIKA_API_KEY=<your datanika_api_key>' -e 'DATANIKA_ALLOW_WRITE=<DATANIKA_ALLOW_WRITE>' -- uvx datanika-mcp==0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.datanika/datanika-mcp إلى مفتاح API؟

نعم. يتطلب DATANIKA_API_KEY، وتضبطها في إعداداته.

هل io.datanika/datanika-mcp مفتوح المصدر؟

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

من يصون io.datanika/datanika-mcp؟

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

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