Dataiku MCP

重要

サポート終了 — 代わりに clssck/dataiku-sdk をご利用ください

Dataiku MCP Server は現在、積極的なメンテナンスを行っていません。 開発は Dataiku DSS SDK に移行しました。これは、スキーマファーストの TypeScript SDK と dss CLI を提供し、より積極的にメンテナンスされているほか、DSS API のより広範な範囲をカバーしています。

• より幅広い範囲をカバー — このサーバーの限定的なツールセットに対し、30 以上の DSS リソースに対応しています。
• スクリプトから実行できる dss CLI と、エージェント向けの機械可読なコマンド仕様。
• Claude、Codex、Cursor、Pi、OMP 向けのエージェントスキルをワンコマンドでインストール。

こちらに移行してください → https://github.com/clssck/dataiku-sdk

---

Dataiku MCP Server

Dataiku DSS REST API 用 MCP サーバーです。フロー分析と、日々の安定した運用（プロジェクト、データセット、レシピ、ジョブ、シナリオ、フォルダー、変数、接続、コード環境）に重点を置いています。

Cursor のワンクリックインストールには、プレースホルダーの環境変数値が含まれています。サーバーを追加した後、DATAIKU_URL、DATAIKU_API_KEY、必要に応じて DATAIKU_PROJECT_KEY を更新してください。

提供内容

• レシピのサブタイプと接続関係を含む、決定論的に正規化されたフローマップ（project.map）。
• 必要に応じて明示的に生データ／詳細を切り替えられる、サマリー優先の出力。
• 幅広いテストカバレッジ（ユニットテスト＋ライブ統合テスト＋任意の破壊的変更を伴う統合テストスイート）。
• 応答における強力なエラー分類：not_found、forbidden、validation、transient、unknown。再試行のヒントも含まれます。

ツールの対応範囲

• project：list、get、metadata、flow、map
• dataset：list、get、schema、preview、metadata、download、create、update、delete
• recipe：list、get、create、update、delete、download
• job：list、get、log、build、buildAndWait、wait、abort
• scenario：list、run、status、get、create、update、delete
• managed_folder：list、get、contents、download、upload、delete_file
• variable：get、set
• connection：infer
• code_env：list、get

前提条件

• Node.js 20+
• npm
• Dataiku DSS の URL と API キー

クイックスタート

npm ci
npm run build

ビルド後、ローカル CLI として実行します。

node dist/index.js

（公開後）npm から直接使用します。

npx -y dataiku-mcp

ローカルでのビルドとテスト

リポジトリのルートから実行する、推奨のローカルワークフロー：

# install deps
npm ci

# static checks
npm run check

# unit tests
npm test

# build distribution
npm run build

# run MCP server locally (dev)
npm start

任意のライブ DSS 統合テスト：

# requires DATAIKU_URL, DATAIKU_API_KEY, DATAIKU_PROJECT_KEY in .env
npm run test:integration

# includes destructive actions (create/update/delete)
DATAIKU_MCP_DESTRUCTIVE_TESTS=1 npm run test:integration

リポジトリの構成

• src/：MCP サーバーとツールの実装。
• tests/：ユニットテストと統合テストのスイート。
• examples/：デモ、フィクスチャ、成果物、個別のローカルスクリプト。
• bin/：パッケージの実行可能エントリーポイント。
• dist/：コンパイル済みの出力（生成物）。

ローカルの環境変数ファイルを作成します。

cp .env.example .env
# then edit .env

開発モードで直接実行します。

npm start

ルートディレクトリが煩雑にならないよう、サンプルスクリプトと出力例は examples/ に保存されています。

環境変数

• DATAIKU_URL：DSS のベース URL
• DATAIKU_API_KEY：DSS API キー
• DATAIKU_PROJECT_KEY（任意）：デフォルトのプロジェクトキー
• DATAIKU_REQUEST_TIMEOUT_MS（任意）：リクエスト試行ごとのタイムアウト（ミリ秒、デフォルト：30000）
• DATAIKU_RETRY_MAX_ATTEMPTS（任意）：再試行が有効なリクエストの最大試行回数（GET のみ、デフォルト：4、上限：10）
• DATAIKU_DEBUG_LATENCY（任意）：1／true に設定すると、ツールごとの所要時間診断情報を structuredContent.debug.latency に含めます（デフォルトではオフ）。

MCP クライアントのセットアップガイド

クライアントでこのサーバーコマンドを使用します（npm パッケージ）。

{
  "command": "npx",
  "args": ["-y", "dataiku-mcp"],
  "env": {
    "DATAIKU_URL": "https://your-dss-instance.app.dataiku.io",
    "DATAIKU_API_KEY": "your_api_key",
    "DATAIKU_PROJECT_KEY": "YOUR_PROJECT_KEY"
  }
}

Windows に関する注意：MCP クライアントがシェルを介さずにコマンドを起動する場合は、npx.cmd を使用してください。

{
  "command": "npx.cmd",
  "args": ["-y", "dataiku-mcp"],
  "env": {
    "DATAIKU_URL": "https://your-dss-instance.app.dataiku.io",
    "DATAIKU_API_KEY": "your_api_key",
    "DATAIKU_PROJECT_KEY": "YOUR_PROJECT_KEY"
  }
}

開発中は TypeScript を直接実行することもできます。

{
  "command": "npx",
  "args": ["tsx", "/absolute/path/to/Dataiku_MCP/src/index.ts"],
  "env": {
    "DATAIKU_URL": "https://your-dss-instance.app.dataiku.io",
    "DATAIKU_API_KEY": "your_api_key",
    "DATAIKU_PROJECT_KEY": "YOUR_PROJECT_KEY"
  }
}

Claude Desktop

1. Claude Desktop を開き、Settings -> Developer -> Edit Config に移動します。
2. claude_desktop_config.json の mcpServers の下に、次を追加します。

{
  "mcpServers": {
    "dataiku": {
      "command": "npx",
      "args": ["-y", "dataiku-mcp"],
      "env": {
        "DATAIKU_URL": "https://your-dss-instance.app.dataiku.io",
        "DATAIKU_API_KEY": "your_api_key",
        "DATAIKU_PROJECT_KEY": "YOUR_PROJECT_KEY"
      }
    }
  }
}

Cursor

Cursor はプロジェクト単位とグローバルの両方の MCP 設定に対応しています。

• プロジェクト単位：.cursor/mcp.json
• グローバル：~/.cursor/mcp.json

例：

{
  "mcpServers": {
    "dataiku": {
      "command": "npx",
      "args": ["-y", "dataiku-mcp"],
      "env": {
        "DATAIKU_URL": "https://your-dss-instance.app.dataiku.io",
        "DATAIKU_API_KEY": "your_api_key",
        "DATAIKU_PROJECT_KEY": "YOUR_PROJECT_KEY"
      }
    }
  }
}

Cline（VS Code 拡張機能）

1. Cline を開き、MCP Servers -> Configure MCP Servers に移動します。
2. cline_mcp_settings.json に次のサーバーブロックを追加します。

{
  "mcpServers": {
    "dataiku": {
      "command": "npx",
      "args": ["-y", "dataiku-mcp"],
      "env": {
        "DATAIKU_URL": "https://your-dss-instance.app.dataiku.io",
        "DATAIKU_API_KEY": "your_api_key",
        "DATAIKU_PROJECT_KEY": "YOUR_PROJECT_KEY"
      }
    }
  }
}

Codex ／プロジェクト単位の MCP 設定

このリポジトリには、プロジェクト単位の MCP ファイル .mcp.json がすでに含まれています。 チェックイン済みの .mcp.json は、クロスプラットフォーム（Windows を含む）で起動できるように node node_modules/tsx/dist/cli.mjs src/index.ts を使用します。先に npm ci を実行してください。

NPM リリースワークフロー

このリポジトリには、手動で実行する GitHub Actions リリースワークフローが含まれています。

• ワークフローファイル：.github/workflows/release.yml
• トリガー：Actions -> Release NPM Package -> Run workflow

入力：

• bump：patch | minor | major
• version：任意の正確なバージョン（bump を上書きします）
• publish：npm に公開するかどうか

リポジトリに必要な設定：

• GitHub 変数：NPM_RELEASE_ENABLED=true
• 任意の変数：NPM_PUBLISH_ACCESS=public
• npmjs.com で、このパッケージ／リポジトリ／ワークフローに対する Trusted Publisher の設定

ワークフローでは、次の処理が行われます。

1. 依存関係をインストールし、チェック／テストを実行して、ビルドします。
2. パッケージのバージョンを上げて、git タグを作成します。
3. コミットとタグを main にプッシュします。
4. GitHub OIDC Trusted Publishing を使って npm に公開します（publish=true の場合）。
5. 生成されたノートを含む GitHub Release を作成します。

Trusted Publishing の設定（npm）：

1. https://www.npmjs.com/package/dataiku-mcp を開き、Settings -> Trusted Publisher に移動します。
2. GitHub Actions を選択します。
3. 次を設定します。
   • Organization or user：clssck
   • Repository：Dataiku_MCP
   • Workflow filename：release.yml
4. 保存します。

Official MCP Registry

このリポジトリは、MCP Registry への公開用に設定されています。

• メタデータファイル：server.json
• ワークフロー：.github/workflows/publish-mcp-registry.yml
• 必須のパッケージフィールド：package.json の mcpName

サーバー名前空間：

• io.github.clssck/dataiku-mcp

公開方法：

1. 手動：GitHub Actions で Publish to MCP Registry を実行します。
2. 自動：npm リリースワークフローを publish=true で実行します（MCP Registry への公開がトリガーされます）。

検証に関する注意：

• server.json.name は package.json.mcpName と一致している必要があります。
• server.json.packages[].identifier と version は、実際に npm で公開されたパッケージを参照している必要があります。

推奨する検証プロンプト

クライアントにサーバーを追加した後、次を実行します。

• project に { "action": "map", "projectKey": "YOUR_PROJECT_KEY" } を指定します（デフォルトは maxNodes=300、maxEdges=600 です。必要に応じて上書きしてください）。

テキスト形式のフロー概要と、structuredContent.map 内の正規化された nodes、edges、stats、roots、leaves が返されます。 切り詰め制限（デフォルトは maxNodes=300、maxEdges=600）が適用されると、structuredContent.truncation に切り詰め前後のノード数とエッジ数、および切り詰めが発生したかどうかが記録されます。

Notes

• project.map は簡潔なテキスト概要を返します。正規化されたグラフ全体は structuredContent.map に含まれます。
• 正規化されたマップ出力内の配列は、差分の不要な変動を抑えるために決定論的な順序で並べ替えられます。
• job.wait と job.buildAndWait は、生の DSS state を保持しながら、structuredContent.normalizedState に terminalSuccess | terminalFailure | timeout | nonTerminal のいずれかを含めます。
• DATAIKU_DEBUG_LATENCY=1 を設定すると、レスポンスの structuredContent.debug.latency に、ツールごとおよび API 呼び出しごとのレイテンシー指標が含まれます。
• リスト形式のレスポンスは、デフォルトでトークン数が制限されます。必要に応じて limit／offset（および maxNodes、maxEdges、maxKeys、maxPackages などのアクション固有の上限）を使って、結果をページ分割するか、範囲を拡張してください。
• dataset.get と job.get は、デフォルトで概要を優先します。structuredContent.definition に DSS JSON 全体を含めるには、includeDefinition=true を指定してください。

ソース

• MCP ローカルサーバー接続ドキュメント：https://modelcontextprotocol.io/docs/develop/connect-local-servers
• Cursor MCP ドキュメント：https://cursor.com/docs/context/mcp
• Cline MCP ドキュメント：https://docs.cline.bot/mcp/configuring-mcp-servers