DataWorks MCP Server

一个模型上下文协议 (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 等客户端)

# 全局安装
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. 验证您的阿里云 Open API 访问密钥和密钥是否正确
2. 检查您的区域 ID 是否正确
3. 确保您位于预期的网络（主网、测试网或开发网）上
4. 验证构建是否成功

依赖项

主要依赖项包括：

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

贡献

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

1. Fork 存储库
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 许可证获得许可。