DataWorks MCP 服务器

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

概览

该MCP服务器：

• 与DataWorks开放API交互
• 管理DataWorks资源

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

前提条件

• Node.js (版本16或更高)
• pnpm（推荐）、npm 或 yarn
• 具有访问密钥和秘密密钥的DataWorks开放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：从源码构建（适用于开发者）

1. 克隆此仓库：

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

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

pnpm install

1. 构建项目：

pnpm run build

1. 开发项目（通过@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代理活动

故障排除

如果遇到问题：

1. 核实您的阿里云开放API访问密钥和秘密密钥是否正确
2. 检查您的区域ID是否正确
3. 确保您处于预期的网络中（主网、测试网或开发网）
4. 核实构建是否成功

依赖项

主要依赖包括：

• @alicloud/dataworks-public20240518
• @alicloud/openapi-client

贡献

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

1. 分叉仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个Pull Request

许可证

该项目采用Apache 2.0许可证。