DataWorks MCP Server

официальный

Сервер протокола контекста модели (MCP), предоставляющий инструменты для ИИ, позволяющие ему взаимодействовать с Open API DataWorks через стандартизированный интерфейс. Эта реализация основана на Aliyun Open API и позволяет AI-агентам беспрепятственно выполнять операции с облачными ресурсами.

Документация

MseeP.ai Security Assessment Badge

Попробуйте DataWorks Agent

Хотите готовый к использованию ИИ-интерфейс для DataWorks без ручной настройки MCP?

DataWorks Agent — это встроенный интеллектуальный помощник Alibaba Cloud для разработки и эксплуатации данных. Он подключается к вашему рабочему пространству DataWorks «из коробки», позволяя вам на естественном языке исследовать метаданные, разрабатывать узлы, диагностировать задачи и управлять ресурсами — без необходимости настройки локального MCP-сервера.

DataWorks AgentЭтот MCP-сервер
Лучше всего подходит дляБыстрый старт в консоли DataWorksПользовательские ИИ-клиенты (Cursor, Cline и др.)
НастройкаОткрыть и использовать в браузереУстановить, настроить AK и подключить MCP
ИнтеграцияНативный опыт работы с DataWorksОткрытый API через протокол MCP

👉 Начать работу: https://dataworks.data.alibabacloud.com/product/agent?source=github

DataWorks MCP Server

Сервер Model Context Protocol (MCP), предоставляющий инструменты для ИИ, позволяя ему взаимодействовать с DataWorks Open API через стандартизированный интерфейс. Эта реализация основана на Aliyun Open API и позволяет ИИ-агентам беспрепятственно выполнять операции с облачными ресурсами.

Если вы предпочитаете встроить возможности DataWorks в собственный рабочий процесс ИИ или IDE, следуйте инструкциям по установке ниже.

Обзор

Этот MCP-сервер:

  • Взаимодействует с DataWorks Open API
  • Управляет ресурсами DataWorks

Сервер реализует спецификацию Model Context Protocol для стандартизации взаимодействия ИИ-агентов с облачными ресурсами.

Предварительные требования

  • Node.js (v16 или выше)
  • pnpm (рекомендуется), npm или yarn
  • DataWorks Open API с ключом доступа и секретным ключом

Установка

Вариант 1: Установка из npm (рекомендуется для клиентов типа Cursor/Cline)

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

# Or install locally in your project
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

Конфигурация

Конфигурация MCP-сервера

Если вы установили через npm (Вариант 1):

{
  "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):

{
  "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": []
    }
  }
}

Настройка окружения

инициализируйте переменные в вашем окружении:

# 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

Описание конфигурации

  • Руководство по использованию Ссылка

Структура проекта

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

Доступные инструменты

MCP-сервер предоставляет следующие инструменты DataWorks:

См. эту ссылку

Вопросы безопасности

  • Храните ваш приватный ключ в безопасности и никому не передавайте
  • Используйте переменные окружения для конфиденциальной информации
  • Регулярно отслеживайте и аудируйте действия ИИ-агентов

Устранение неполадок

Если вы столкнулись с проблемами:

  1. Убедитесь, что ваш ключ доступа и секретный ключ Aliyun Open API верны
  2. Проверьте правильность идентификатора региона
  3. Убедитесь, что вы находитесь в нужной сети (mainnet, testnet или devnet)
  4. Убедитесь, что сборка прошла успешно

Зависимости

Ключевые зависимости включают:

Участие в разработке

Приветствуются ваши вклады! Пожалуйста, не стесняйтесь отправлять 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 License.