Alibabacloud Dataworks MCP Server

🚀 阿里云DataWorks MCP服务器

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

🚀 快速开始

阿里云DataWorks MCP服务器允许AI操作借助标准接口与DataWorks开放API交互，基于阿里云Open API实现，可使AI代理无缝执行云资源操作。以下是使用前的准备和操作步骤。

✨ 主要特性

• 与DataWorks Open API交互：服务器可与DataWorks Open API进行交互，为AI操作提供支持。
• 管理DataWorks资源：能够对DataWorks的资源进行有效管理。
• 标准化互动：实现了模型上下文协议规范，使AI代理与云资源的互动更加标准化。

📦 安装指南

选项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

💻 使用示例

基础用法

项目提供了一系列命令，用于项目的安装、开发、构建和测试。

# 安装项目
npm install

# 启动开发服务器
npm run dev

# 构建项目
npm run build

# 运行测试
npm test

📚 详细文档

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            # 项目文档

🔧 技术细节

依赖项

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

📄 许可证

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

⚠️ 重要提示

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

💡 使用建议

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

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

🤝 贡献

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

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