# MCP数据管理服务
## 基本信息
- Slug: `aliyun-alibabacloud-dataworks-mcp-server`
- Source: modelscope
- Publisher: @aliyun/alibabacloud-dataworks-mcp-server
- Categories: cloud-platforms / developer-tools
- Hosted: Yes
- License: Apache License 2.0
- Source URL: https://www.modelscope.cn/mcp/servers/@aliyun/alibabacloud-dataworks-mcp-server
## 简介
一种模型上下文协议服务器， enables 人工智能代理通过标准化接口与阿里云DataWorks进行交互，从而通过DataWorks开放API无缝管理DataWorks资源和操作。
## 安装提示

```bash
# Install globally npm install -g alibabacloud-dataworks-mcp-server # Or install locally in your project npm install alibabacloud-dataworks-mcp-server
```

## MCP Server 详情

# DataWorks MCP 服务器

这是一个提供给AI的模型上下文协议（MCP）服务器，通过标准化接口与DataWorks开放API进行交互。此实现基于阿里云开放API，使AI代理能够无缝执行云资源操作。

## 概览

该MCP服务器：

* 与DataWorks开放API交互
* 管理DataWorks资源

服务器实现了模型上下文协议规范，以标准化AI代理的云资源交互。

## 前提条件

* Node.js (版本16或更高)
* pnpm（推荐）、npm 或 yarn
* 具有访问密钥和秘密密钥的DataWorks开放API

## 安装

### 选项1：从npm安装（推荐用于Cursor/Cline等客户端）

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

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


### 选项2：从源码构建（适用于开发者）

1. 克隆此仓库：
```bash
git clone https://github.com/aliyun/alibabacloud-dataworks-mcp-server
cd alibabacloud-dataworks-mcp-server
```


2. 安装依赖（推荐使用pnpm，支持npm）：
```bash
pnpm install
```


3. 构建项目：
```bash
pnpm run build
```


4. 开发项目（通过@modelcontextprotocol/inspector）：
```bash
pnpm run dev
```
打开 [http://localhost:5173](http://localhost:5173)

## 配置

### MCP 服务器配置

如果您是通过npm安装的（选项1）：
```json
{
  "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）：
```json
{
  "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": []
    }
  }
}
```


### 环境设置

在您的环境中初始化变量：

```env
# 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
```


### 配置说明
- 使用指南说明 [链接](https://www.alibabacloud.com/help/dataworks/user-guide/dataworks-mcp-server-function-usage#1ecf2a04b5ilh)

## 项目结构

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


## 可用工具

MCP服务器提供了以下DataWorks工具：

参见此 [链接](https://dataworks.data.aliyun.com/dw-pop-mcptools)

## 安全考虑

* 保持您的私钥安全且不要分享
* 对敏感信息使用环境变量
* 定期监控并审核AI代理活动

## 故障排除

如果遇到问题：

1. 核实您的阿里云开放API访问密钥和秘密密钥是否正确
2. 检查您的区域ID是否正确
3. 确保您处于预期的网络中（主网、测试网或开发网）
4. 核实构建是否成功

## 依赖项

主要依赖包括：
* [@alicloud/dataworks-public20240518](https://github.com/alibabacloud-sdk-swift/dataworks-public-20240518)
* [@alicloud/openapi-client](https://github.com/aliyun/darabonba-openapi)

## 贡献

欢迎贡献！请随时提交Pull Request。

1. 分叉仓库
2. 创建您的功能分支 (`git checkout -b feature/amazing-feature`)
3. 提交您的更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 打开一个Pull Request

## 许可证

该项目采用Apache 2.0许可证。