Alibaba Cloud DataWorks

What is alibabacloud-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.

How to use alibabacloud-dataworks-mcp-server?

To use the server, you can either install it from npm or build it from the source. After installation, you need to configure the MCP server with your DataWorks Open API region and Alibaba Cloud access credentials. Then, you can run the server and interact with it using an MCP client.

Key features of alibabacloud-dataworks-mcp-server

Interacts with DataWorks Open API
Manages DataWorks resources
Standardizes cloud resource interactions for AI agents

Use cases of alibabacloud-dataworks-mcp-server

Automating DataWorks resource management tasks using AI agents
Integrating DataWorks with other AI tools and services
Building custom AI-powered data applications on top of DataWorks

FAQ from the project

There is no FAQ section in the project's README file.

DataWorks MCP Server

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

# 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:

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

open http://localhost:5173

Configuration

MCP Server Configuration

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": []
    }
  }
}

Environment Setup

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

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.

Alibaba Cloud DataWorks