返回 MCP 目录
public公开dns本地运行

alibabacloud-dataworks-mcp-server

DataWorks MCP服务器为AI提供标准化接口,实现与阿里云DataWorks Open API的无缝交互。

article

README

🚀 阿里云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
  1. 安装依赖项(推荐使用pnpm,也支持npm):
pnpm install
  1. 构建项目:
pnpm run build
  1. 开发项目(由@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            # 项目文档

🔧 技术细节

依赖项

📄 许可证

本项目根据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。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端