DataWorks MCP Server

官方

一個模型上下文協定（MCP）伺服器，提供AI工具，使其能透過標準化介面與DataWorks Open API互動。此實作基於阿里雲開放API，讓AI代理能無縫執行雲端資源操作。

文件

試用 DataWorks Agent

想要在 DataWorks 中獲得即開即用的 AI 體驗，而無需手動設定 MCP 嗎？

DataWorks Agent 是阿里雲內建的資料開發與維運智慧助理。它能直接連接您的 DataWorks 工作空間，讓您可以使用自然語言來探索中繼資料、開發節點、排除任務問題及管理資源——無需進行本機 MCP 伺服器設定。

	DataWorks Agent	此 MCP 伺服器
最適合	在 DataWorks 主控台中快速入門	自訂 AI 客戶端（Cursor、Cline 等）
設定	在瀏覽器中開啟並使用	安裝、設定 AK 並連接 MCP
整合	原生 DataWorks 體驗	透過 MCP 協定開放 API

👉 立即開始： https://dataworks.data.alibabacloud.com/product/agent?source=github

DataWorks MCP 伺服器

一個模型上下文協定（MCP）伺服器，為 AI 提供工具，使其能透過標準化介面與 DataWorks Open API 互動。此實作基於阿里雲 Open API，讓 AI 代理能夠無縫執行雲端資源操作。

如果您偏好將 DataWorks 功能嵌入自己的 AI 工作流程或 IDE 中，請遵循下方的安裝指南。

概覽

此 MCP 伺服器：

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

環境設定

在您的環境中初始化變數：

# 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 代理活動

疑難排解

如果您遇到問題：

確認您的阿里雲 Open API 存取金鑰和秘密金鑰正確無誤
檢查您的區域 ID 是否正確
確保您處於預期的網路（主網、測試網或開發網）
確認建置已成功

相依套件

主要相依套件包括：

貢獻

歡迎貢獻！請隨時提交 Pull Request。

Fork 此儲存庫
建立您的功能分支（git checkout -b feature/amazing-feature）
提交您的變更（git commit -m 'Add some amazing feature'）
推送到分支（git push origin feature/amazing-feature）
開啟 Pull Request

授權

本專案採用 Apache 2.0 授權條款。