DataWorks MCP Server

Dùng thử DataWorks Agent

Bạn muốn có trải nghiệm AI sẵn sàng sử dụng cho DataWorks mà không cần thiết lập MCP thủ công?

DataWorks Agent là trợ lý thông minh tích hợp sẵn của Alibaba Cloud dành cho phát triển và vận hành dữ liệu. Nó kết nối trực tiếp với không gian làm việc DataWorks của bạn, cho phép bạn sử dụng ngôn ngữ tự nhiên để khám phá metadata, phát triển node, khắc phục sự cố tác vụ và quản lý tài nguyên—không cần cấu hình máy chủ MCP cục bộ.

	DataWorks Agent	Máy chủ MCP này
Phù hợp nhất	Bắt đầu nhanh trong bảng điều khiển DataWorks	Các ứng dụng AI tùy chỉnh (Cursor, Cline, v.v.)
Thiết lập	Mở và sử dụng trong trình duyệt	Cài đặt, cấu hình AK và kết nối MCP
Tích hợp	Trải nghiệm DataWorks gốc	API mở qua giao thức MCP

👉 Bắt đầu: https://dataworks.data.alibabacloud.com/product/agent?source=github

Máy chủ DataWorks MCP

Máy chủ Model Context Protocol (MCP) cung cấp các công cụ cho AI, cho phép nó tương tác với DataWorks Open API thông qua giao diện chuẩn hóa. Việc triển khai này dựa trên Aliyun Open API và cho phép các tác nhân AI thực hiện các thao tác tài nguyên đám mây một cách liền mạch.

Nếu bạn muốn nhúng các khả năng của DataWorks vào quy trình làm việc AI hoặc IDE của riêng mình, hãy làm theo hướng dẫn cài đặt bên dưới.

Tổng quan

Máy chủ MCP này:

• Tương tác với DataWorks Open API
• Quản lý tài nguyên DataWorks

Máy chủ triển khai đặc tả Model Context Protocol để chuẩn hóa các tương tác tài nguyên đám mây cho các tác nhân AI.

Điều kiện tiên quyết

• Node.js (v16 trở lên)
• pnpm (khuyến nghị), npm hoặc yarn
• DataWorks Open API với access key và secret key

Cài đặt

Tùy chọn 1: Cài đặt từ npm (khuyến nghị cho các ứng dụng như Cursor/Cline)

# Install globally
npm install -g alibabacloud-dataworks-mcp-server

# Or install locally in your project
npm install alibabacloud-dataworks-mcp-server

Tùy chọn 2: Xây dựng từ mã nguồn (dành cho nhà phát triển)

1. Sao chép kho lưu trữ này:

git clone https://github.com/aliyun/alibabacloud-dataworks-mcp-server
cd alibabacloud-dataworks-mcp-server

2. Cài đặt các gói phụ thuộc (khuyến nghị dùng pnpm, hỗ trợ npm):

pnpm install

3. Xây dựng dự án:

pnpm run build

4. Phát triển dự án (bằng @modelcontextprotocol/inspector):

pnpm run dev

mở http://localhost:5173

Cấu hình

Cấu hình Máy chủ MCP

Nếu bạn đã cài đặt qua npm (Tùy chọn 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": []
    }
  }
}

Nếu bạn xây dựng từ mã nguồn (Tùy chọn 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": []
    }
  }
}

Thiết lập Môi trường

khởi tạo các biến trong môi trường của bạn:

# 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

Mô tả Cấu hình

• Mô tả Hướng dẫn Sử dụng Liên kết

Cấu trúc Dự án

alibabacloud-dataworks-mcp-server/
├── src/
│   ├── index.ts          # Main entry point
├── package.json
└── tsconfig.json

Công cụ Có sẵn

Máy chủ MCP cung cấp các công cụ DataWorks sau:

Xem liên kết này

Cân nhắc Bảo mật

• Giữ khóa riêng tư của bạn an toàn và không bao giờ chia sẻ nó
• Sử dụng biến môi trường cho thông tin nhạy cảm
• Thường xuyên giám sát và kiểm tra các hoạt động của tác nhân AI

Khắc phục sự cố

Nếu bạn gặp sự cố:

1. Xác minh access key và secret key Aliyun Open API của bạn là chính xác
2. Kiểm tra region id của bạn là chính xác
3. Đảm bảo bạn đang ở mạng mong muốn (mainnet, testnet hoặc devnet)
4. Xác minh quá trình xây dựng đã thành công

Gói phụ thuộc

Các gói phụ thuộc chính bao gồm:

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

Đóng góp

Hoan nghênh các đóng góp! Vui lòng gửi Pull Request.

1. Fork kho lưu trữ
2. Tạo nhánh tính năng của bạn (git checkout -b feature/amazing-feature)
3. Commit các thay đổi của bạn (git commit -m 'Add some amazing feature')
4. Đẩy lên nhánh (git push origin feature/amazing-feature)
5. Mở Pull Request

Giấy phép

Dự án này được cấp phép theo Giấy phép Apache 2.0.