DataWorks MCP 服务器

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

概述

此 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代理活动

故障排除

如果您遇到问题：

验证您的阿里云开放API访问密钥和密钥是否正确
检查你的区域 ID 是否正确
确保您位于目标网络（主网、测试网或开发网）上
验证构建是否成功

依赖项

关键依赖项包括：

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

执照

该项目采用 Apache 2.0 许可证授权。

DataWorks MCP Server

Integrations