阿里云DataWorks MCP服务器

一个基于模型上下文协议（MCP）的服务器，提供工具以支持AI操作，使其能够通过标准接口与DataWorks开放API交互。该实现基于阿里云Open API，使AI代理能够无缝执行云资源操作。

概述

此MCP服务器：

• 与DataWorks Open API交互
• 管理DataWorks资源

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

先决条件

• Node.js（v16或更高版本）
• pnpm（推荐）、npm或yarn
• 配备访问密钥和秘密密钥的DataWorks Open API

安装

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

# 全局安装
npm install -g alibabacloud-dataworks-mcp-server

# 或者在项目中本地安装
npm install alibabacloud-dataworks-mcp-server

选项2：从源代码构建（针对开发者）

1. 克隆此仓库：

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

2. 安装依赖项（推荐使用pnpm，也支持npm）：

pnpm install

3. 构建项目：

pnpm run build

4. 开发项目（由@modelcontextprotocol/inspector开发）：

pnpm run dev

打开http://localhost:5173

配置

MCP服务器配置

如果通过npm安装（选项1）：

{
  "mcpServers": {
    "alibabacloud-dataworks-mcp-server": {
      "command": "npx",
      "args": "alibabacloud-dataworks-mcp-server"
    }
  }
}

示例配置文件：

{
  "mcpServers": {
    "alibabacloud-dataworks-mcp-server": {
      "command": "node",
      "args": "./dist/server.js"
    }
  }
}

环境变量

请参考项目中的README.md或相关文档设置环境变量。

项目结构

.
├── src/
│   ├── server.ts          # 服务器入口文件
│   └── utils/           # 工具和辅助函数
├── package.json         # 依赖项和脚本
└── README.md            # 项目文档

可用工具

命令列表

# 安装项目
npm install

# 启动开发服务器
npm run dev

# 构建项目
npm run build

# 运行测试
npm test

安全注意事项

• 保护好私钥和访问令牌。
• 使用环境变量存储敏感信息，避免明文存储。
• 定期更新凭据，并限制其使用范围。

故障排除

如果遇到问题，请检查以下内容：

1. 确保安装了正确的依赖项。
2. 检查网络连接是否正常。
3. 查看控制台输出以获取错误信息。

依赖项

• @alicloud/dataworks-public-20240518 - 数据工厂公共API
• @alicloud/openapi-client - Open API客户端

贡献

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

1. 叉克隆仓库。
2. 创建功能分支（git checkout -b feature/amazing-feature）。
3. 提交更改（git commit -m '添加一些很棒的功能'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 打开Pull Request。

许可证

本项目根据Apache 2.0许可证发布。