Try DataWorks Agent
Want a ready-to-use AI experience for DataWorks without manual MCP setup?
DataWorks Agent is Alibaba Cloud's built-in intelligent assistant for data development and operations. It connects to your DataWorks workspace out of the box, so you can use natural language to explore metadata, develop nodes, troubleshoot tasks, and manage resources—no local MCP server configuration required.
| DataWorks Agent | This MCP Server | |
|---|---|---|
| Best for | Quick start in the DataWorks console | Custom AI clients (Cursor, Cline, etc.) |
| Setup | Open and use in browser | Install, configure AK, and connect MCP |
| Integration | Native DataWorks experience | Open API via MCP protocol |
👉 Get started: https://dataworks.data.alibabacloud.com/product/agent?source=github
DataWorks MCP Server
A Model Context Protocol (MCP) server that provides tools for AI, allowing it to interact with the DataWorks Open API through a standardized interface. This implementation is based on the Aliyun Open API and enables AI agents to perform cloud resources operations seamlessly.
If you prefer embedding DataWorks capabilities into your own AI workflow or IDE, follow the installation guide below.
Overview
This MCP server:
- Interact with DataWorks Open API
- Manage DataWorks resources
The server implements the Model Context Protocol specification to standardize cloud resource interactions for AI agents.
Prerequisites
- Node.js (v16 or higher)
- pnpm (recommended), npm, or yarn
- DataWorks Open API with access key and secret key
Installation
Option 1: Install from npm (recommend for clients like Cursor/Cline)
bash# Install globally npm install -g alibabacloud-dataworks-mcp-server # Or install locally in your project npm install alibabacloud-dataworks-mcp-server
Option 2: Build from Source (for developers)
- Clone this repository:
bashgit clone https://github.com/aliyun/alibabacloud-dataworks-mcp-server cd alibabacloud-dataworks-mcp-server
- Install dependencies (pnpm is recommended, npm is supported):
bashpnpm install
- Build the project:
bashpnpm run build
- Development the project (by @modelcontextprotocol/inspector):
bashpnpm run dev
Configuration
MCP Server Configuration
If you installed via npm (Option 1):
json{ "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": [] } } }
If you built from source (Option 2):
json{ "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": [] } } }
Environment Setup
init variables in your environment:
env# 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
Configuration Description
- Use Guide Description Link
Project Structure
alibabacloud-dataworks-mcp-server/ ├── src/ │ ├── index.ts # Main entry point ├── package.json └── tsconfig.json
Available Tools
The MCP server provides the following DataWorks tools:
See this link
Security Considerations
- Keep your private key secure and never share it
- Use environment variables for sensitive information
- Regularly monitor and audit AI agent activities
Troubleshooting
If you encounter issues:
- Verify your Aliyun Open API access key and secret key are correct
- Check your region id is correct
- Ensure you're on the intended network (mainnet, testnet, or devnet)
- Verify the build was successful
Dependencies
Key dependencies include:
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the Apache 2.0 License.
