DataWorks MCP 服务器

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

概述

此MCP服务器：

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

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

预备条件

• Node.js（v16或更高版本）
• pnpm（推荐），npm 或 yarn
• 带有访问密钥和秘密密钥的DataWorks开放API

安装

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

# 全局安装
npm install -g alibabacloud-dataworks-mcp-server

# 或在项目中本地安装
npm install alibabacloud-dataworks-mcp-server

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

1. 克隆此仓库：

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

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

pnpm install

3. 构建项目：

pnpm run build

4. 开发项目（通过@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配置
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          # 主入口点
├── 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 '添加一些惊人的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个Pull Request

许可证

本项目采用Apache 2.0许可证。