Dataiku MCP

🚀 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，並提供重試提示。

📦 安裝指南

前提條件

• Node.js 20+
• npm
• Dataiku DSS URL + API密鑰

快速開始

npm ci
npm run build

構建後作為本地CLI運行：

node dist/index.js

直接從npm使用（發佈後）：

npx -y dataiku-mcp

本地構建和測試

從倉庫根目錄推薦的本地工作流程：

# 安裝依賴
npm ci

# 靜態檢查
npm run check

# 單元測試
npm test

# 構建發行版
npm run build

# 本地運行MCP服務器（開發模式）
npm start

可選的即時DSS集成測試：

# 需要在.env文件中設置DATAIKU_URL、DATAIKU_API_KEY、DATAIKU_PROJECT_KEY
npm run test:integration

# 包括破壞性操作（創建/更新/刪除）
DATAIKU_MCP_DESTRUCTIVE_TESTS=1 npm run test:integration

💻 使用示例

基礎用法

• 創建本地環境文件：

cp .env.example .env
# 然後編輯.env文件

• 在開發環境中直接運行：

npm start

高級用法

不同客戶端的MCP服務器設置

Claude Desktop

1. 打開Claude Desktop -> 設置 -> 開發者 -> 編輯配置。
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服務器 -> 配置MCP服務器。
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.json 中包含項目範圍的MCP文件。 已提交的 .mcp.json 使用 node node_modules/tsx/dist/cli.mjs src/index.ts 進行跨平臺啟動（包括Windows）；請先運行 npm ci。

📚 詳細文檔

工具覆蓋範圍

環境變量

NPM發佈工作流

此倉庫包含一個手動的GitHub Actions發佈工作流：

• 工作流文件：.github/workflows/release.yml
• 觸發方式：Actions -> 發佈NPM包 -> 運行工作流

輸入參數：

• bump：patch、minor 或 major
• version（可選）：精確版本號（覆蓋 bump）
• publish：是否發佈到npm

所需的倉庫配置：

• GitHub變量：NPM_RELEASE_ENABLED=true
• 可選變量：NPM_PUBLISH_ACCESS=public
• 在npmjs.com上為此包/倉庫/工作流配置受信任的發佈者

工作流將執行以下操作：

1. 安裝依賴項、運行檢查/測試並構建。
2. 提升包版本並創建git標籤。
3. 將提交和標籤推送到 main 分支。
4. 使用GitHub OIDC受信任發佈功能將包發佈到npm（如果 publish=true）。
5. 創建帶有生成說明的GitHub版本。

受信任發佈設置（npm）

1. 打開 https://www.npmjs.com/package/dataiku-mcp -> 設置 -> 受信任的發佈者。
2. 選擇 GitHub Actions。
3. 設置：
   • 組織或用戶：clssck
   • 倉庫：Dataiku_MCP
   • 工作流文件名：release.yml
4. 保存。

官方MCP註冊表

此倉庫已配置為發佈到MCP註冊表：

• 元數據文件：server.json
• 工作流：.github/workflows/publish-mcp-registry.yml
• 必需的包字段：package.json 中的 mcpName

服務器命名空間：

• io.github.clssck/dataiku-mcp

發佈路徑：

1. 手動：在GitHub Actions中運行 發佈到MCP註冊表。
2. 自動：運行npm發佈工作流並設置 publish=true（它將觸發MCP註冊表發佈）。

驗證說明：

• 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 會報告截斷前後的節點和邊數量以及是否發生了截斷。

注意事項

• 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 以摘要為先；傳遞 includeDefinition=true 可在 structuredContent.definition 中包含完整的DSS JSON。

參考資料

• 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