使用说明
试用DataWorks代理
想要在没有手动MCP设置的情况下为DataWorks提供现成的AI体验吗？
DataWorks代理 是阿里云内置的数据开发和运营智能助手。它开箱即用地连接到您的DataWorks工作区，因此您可以使用自然语言来探索元数据、开发节点、排除任务故障和管理资源——不需要本地MCP服务器配置。
| DataWorks代理 | 此MCP服务器 | |
|---|---|---|
| 最适合 | DataWorks控制台中的快速入门 | 自定义AI客户端（Cursor、Cline等） |
| 设置 | 在浏览器中打开和使用 | 安装、配置AK并连接MCP |
| 整合 | 本机DataWorks体验 | 通过MCP协议打开API |
👉 开始： https://dataworks.data.alibabacloud.com/product/agent?source=github
DataWorks MCP服务器
为人工智能提供工具的模型上下文协议（MCP）服务器，允许其通过标准化接口与DataWorksOpen API交互。该实现基于Aliyun Open API，使人工智能代理能够无缝执行云资源操作。
如果您更喜欢将DataWorks功能嵌入到自己的AI工作流或IDE中，请按照下面的安装指南进行操作。
概述
此MCP服务器：
- 与DataWorksOpen 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": []
}
}
}
环境设置
环境中的init变量：
# 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代理活动
故障排除
如果您遇到问题：
- 验证您的Aliyun Open API访问密钥和密钥是否正确
- 检查您的地区id是否正确
- 确保您在预期的网络（主网、测试网或开发网）上
- 验证构建是否成功
依赖项
关键依赖关系包括：
贡献
欢迎投稿！请随时提交拉取请求。
- 分叉存储库
- 创建功能分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add some amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
许可证
此项目根据Apache 2.0许可证获得许可。
