Aliyun Alibabacloud Dataworks MCP Server

🚀 數據工作臺 MCP 服務器

數據工作臺 MCP 服務器基於阿里雲開放 API 實現了模型上下文協議（MCP）。它為 AI 提供了一個統一接口，使其能夠與數據工作臺開放 API 進行交互，從而讓 AI 代理可以無縫操作雲端資源。

🚀 快速開始

數據工作臺 MCP 服務器是一個基於阿里雲開放 API 的模型上下文協議（MCP）服務器，它為 AI 提供了與數據工作臺開放 API 交互的統一接口，實現了 AI 代理對雲端資源的無縫操作。

✨ 主要特性

• 與數據工作臺開放 API 交互：服務器可與數據工作臺開放 API 進行交互，實現對雲端數據資源的操作。
• 管理數據工作臺資源：能夠對數據工作臺的各類資源進行有效管理。
• 遵循模型上下文協議規範：通過統一接口管理雲端數據資源，確保操作的規範性和一致性。

📦 安裝指南

方式一：通過 npm 安裝

npm install alibabacloud-dataworks-mcp-server

方式二：克隆項目倉庫

git clone https://github.com/your-username/alibabacloud-dataworks-mcp-server.git
cd alibabacloud-dataworks-mcp-server
npm install

📚 詳細文檔

先決條件

• Node.js 環境：請確保已安裝最新穩定版 Node.js。
• npm 包管理器：確認 npm 已正確配置。
• 阿里雲訪問密鑰：需具備有效的阿里雲訪問秘鑰 ID 和秘鑰。
• 數據工作臺賬號：擁有數據工作臺使用權限。

配置指南

環境變量配置

創建一個 .env 文件，並添加以下內容：

# 必填項
ALIBABA_CLOUD_REGION_ID=cn-hangzhou  # 替換為你的區域ID
ALIBABA_CLOUD_ACCESS_KEY_ID=your_key_id  # 替換為你的訪問秘鑰 ID
ALIBABA_CLOUD_SECRET_ACCESS_KEY=your_secret_key  # 替換為你的訪問秘鑰

# 可選配置項
TOOL_CATEGORIES="數據開發（新版）,UTILS"  # 工具分類白名單，用逗號分隔
TOOL_NAMES="CreateNode,UpdateNode"      # 工具名稱白名單，用逗號分隔
VERBOSE=true                            # 調試模式開關

配置文件結構

項目啟動後會自動生成配置文件 config.json，內容如下：

{
  "regionId": "cn-hangzhou",
  "accessKeyId": "your_key_id",
  "secretAccessKey": "your_secret_key",
  "toolCategories": ["數據開發（新版）", "UTILS"],
  "toolNames": ["CreateNode", "UpdateNode"],
  "verbose": true
}

項目結構

alibabacloud-dataworks-mcp-server/
├── src/
│   ├── index.ts          # 程序入口文件
└── package.json         # 項目依賴管理文件

可用工具

MCP 服務器提供的 數據工作臺 工具包括：

• 數據節點創建與管理
• 數據開發環境配置
• 資源訪問控制
• 日誌查詢功能
• 安全策略配置

如需瞭解詳細列表，請參考 官方文檔

安全注意事項

⚠️ 重要提示

• 請妥善保管您的私鑰，防止洩露。
• 敏感信息應使用環境變量存儲。
• 建議定期審計 AI 代理的活動記錄。

故障排除

遇到問題時，請按以下步驟排查：

1. 確認阿里雲訪問秘鑰配置正確。
2. 檢查區域 ID 是否準確無誤。
3. 確保使用正確的網絡環境（主網/測試網）。
4. 驗證構建過程是否成功完成。

依賴項說明

項目主要依賴以下包：

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

項目貢獻

歡迎任何貢獻！請參考以下步驟參與：

1. Fork 此倉庫。
2. 創建功能分支（git checkout -b feature/amazing-feature）。
3. 提交修改（git commit -m '添加神奇功能'）。
4. 推送到遠程分支（git push origin feature/amazing-feature）。
5. 提交 Pull Request。

📄 許可證

本項目採用 Apache 2.0 協議開源。