DataWorks MCP Server

官方

一个基于模型上下文协议（MCP）的服务器，提供工具供AI使用，使其能够通过标准化接口与DataWorks开放API进行交互。该实现基于阿里云开放API，使AI代理能够无缝执行云资源操作。

文档

试用 DataWorks Agent

想要开箱即用的 DataWorks AI 体验，无需手动配置 MCP？

DataWorks Agent 是阿里云内置的智能助手，用于数据开发与运维。它开箱即用地连接到您的 DataWorks 工作空间，让您可以使用自然语言探索元数据、开发节点、排查任务以及管理资源——无需本地 MCP 服务器配置。

	DataWorks Agent	此 MCP 服务器
最适合	在 DataWorks 控制台中快速上手	自定义 AI 客户端（Cursor、Cline 等）
设置	在浏览器中打开并使用	安装、配置 AK 并连接 MCP
集成	原生 DataWorks 体验	通过 MCP 协议开放 API

👉 开始使用： https://dataworks.data.alibabacloud.com/product/agent?source=github

DataWorks MCP 服务器

一个模型上下文协议（MCP）服务器，为 AI 提供工具，使其能够通过标准化接口与 DataWorks Open API 交互。此实现基于阿里云 Open API，使 AI 代理能够无缝执行云资源操作。

如果您希望将 DataWorks 功能嵌入到自己的 AI 工作流或 IDE 中，请按照下面的安装指南操作。

概述

此 MCP 服务器：

与 DataWorks Open API 交互
管理 DataWorks 资源

该服务器实现了模型上下文协议规范，以标准化 AI 代理的云资源交互。

先决条件

Node.js（v16 或更高版本）
pnpm（推荐）、npm 或 yarn
具有访问密钥和秘密密钥的 DataWorks Open API

安装

选项 1：从 npm 安装（推荐用于 Cursor/Cline 等客户端）

# Install globally
npm install -g alibabacloud-dataworks-mcp-server

# Or install locally in your project
npm install alibabacloud-dataworks-mcp-server

选项 2：从源代码构建（适用于开发者）

克隆此仓库：

git clone https://github.com/aliyun/alibabacloud-dataworks-mcp-server
cd alibabacloud-dataworks-mcp-server

安装依赖项（推荐使用 pnpm，也支持 npm）：

pnpm install

构建项目：

pnpm run build

开发项目（通过 @modelcontextprotocol/inspector）：

pnpm run dev

打开 http://localhost:5173

配置

MCP 服务器配置

如果您通过 npm 安装（选项 1）：

{
  "mcpServers": {
    "alibabacloud-dataworks-mcp-server": {
      "command": "npx",
      "args": ["alibabacloud-dataworks-mcp-server"],
      "env": {
        "REGION": "your_dataworks_open_api_region_id_here",
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_alibaba_cloud_access_key_id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_alibaba_cloud_access_key_secret",
        "TOOL_CATEGORIES": "optional_your_tool_categories_here_ex_UTILS",
        "TOOL_NAMES": "optional_your_tool_names_here_ex_ListProjects"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

如果您从源代码构建（选项 2）：

{
  "mcpServers": {
    "alibabacloud-dataworks-mcp-server": {
      "command": "node",
      "args": ["/path/to/alibabacloud-dataworks-mcp-server/build/index.js"],
      "env": {
        "REGION": "your_dataworks_open_api_region_id_here",
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_alibaba_cloud_access_key_id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_alibaba_cloud_access_key_secret",
        "TOOL_CATEGORIES": "optional_your_tool_categories_here_ex_SERVER_IDE_DEFAULT",
        "TOOL_NAMES": "optional_your_tool_names_here_ex_ListProjects"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

环境设置

在您的环境中初始化变量：

# DataWorks Configuration
REGION=your_dataworks_open_api_region_id_here
ALIBABA_CLOUD_ACCESS_KEY_ID=your_alibaba_cloud_access_key_id
ALIBABA_CLOUD_ACCESS_KEY_SECRET=your_alibaba_cloud_access_key_secret
TOOL_CATEGORIES=optional_your_tool_categories_here_ex_SERVER_IDE_DEFAULT
TOOL_NAMES=optional_your_tool_names_here_ex_ListProjects

配置说明

使用指南说明链接

项目结构

alibabacloud-dataworks-mcp-server/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

可用工具

MCP 服务器提供以下 DataWorks 工具：

请参阅此链接

安全注意事项

确保您的私钥安全，切勿分享
对敏感信息使用环境变量
定期监控和审计 AI 代理活动

故障排除

如果您遇到问题：

验证您的阿里云 Open API 访问密钥和秘密密钥是否正确
检查您的区域 ID 是否正确
确保您处于预期的网络（主网、测试网或开发网）
验证构建是否成功

依赖项

关键依赖项包括：

贡献

欢迎贡献！请随时提交 Pull Request。

Fork 该仓库
创建您的功能分支（git checkout -b feature/amazing-feature）
提交您的更改（git commit -m 'Add some amazing feature'）
推送到分支（git push origin feature/amazing-feature）
打开一个 Pull Request

许可证

本项目根据 Apache 2.0 许可证授权。