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.
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.
- Node.js (v16 or higher)
- pnpm (recommended), npm, or yarn
- DataWorks Open API with access key and secret key
# Install globally npm install -g alibabacloud-dataworks-mcp-server # Or install locally in your project npm install alibabacloud-dataworks-mcp-server
- Clone this repository:
git clone https://github.com/aliyun/alibabacloud-dataworks-mcp-server cd alibabacloud-dataworks-mcp-server
- Install dependencies (pnpm is recommended, npm is supported):
pnpm install
- Build the project:
pnpm run build
- Development the project (by @modelcontextprotocol/inspector):
pnpm run dev
If you installed via npm (Option 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": [] } } }
If you built from source (Option 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 variables in your environment:
# 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
- Use Guide Description Link
alibabacloud-dataworks-mcp-server/ ├── src/ │ ├── index.ts # Main entry point ├── package.json └── tsconfig.json
The MCP server provides the following DataWorks tools:
See this link
- Keep your private key secure and never share it
- Use environment variables for sensitive information
- Regularly monitor and audit AI agent activities
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
Key dependencies include:
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
This project is licensed under the Apache 2.0 License.