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