DataWorks MCP Server

Experimente o DataWorks Agent

Quer uma experiência de IA pronta para uso no DataWorks sem configuração manual do MCP?

O DataWorks Agent é o assistente inteligente integrado do Alibaba Cloud para desenvolvimento e operações de dados. Ele se conecta ao seu workspace do DataWorks de forma nativa, permitindo que você use linguagem natural para explorar metadados, desenvolver nós, solucionar problemas em tarefas e gerenciar recursos — sem necessidade de configurar um servidor MCP local.

	DataWorks Agent	Este Servidor MCP
Ideal para	Início rápido no console do DataWorks	Clientes de IA personalizados (Cursor, Cline, etc.)
Configuração	Abrir e usar no navegador	Instalar, configurar AK e conectar MCP
Integração	Experiência nativa do DataWorks	API aberta via protocolo MCP

👉 Comece agora: https://dataworks.data.alibabacloud.com/product/agent?source=github

Servidor MCP do DataWorks

Um servidor Model Context Protocol (MCP) que fornece ferramentas para IA, permitindo interagir com a API aberta do DataWorks por meio de uma interface padronizada. Esta implementação é baseada na API aberta do Aliyun e permite que agentes de IA realizem operações em recursos de nuvem de forma transparente.

Se você prefere incorporar as funcionalidades do DataWorks em seu próprio fluxo de trabalho de IA ou IDE, siga o guia de instalação abaixo.

Visão Geral

Este servidor MCP:

• Interage com a API aberta do DataWorks
• Gerencia recursos do DataWorks

O servidor implementa a especificação Model Context Protocol para padronizar as interações de agentes de IA com recursos de nuvem.

Pré-requisitos

• Node.js (v16 ou superior)
• pnpm (recomendado), npm ou yarn
• API aberta do DataWorks com chave de acesso e chave secreta

Instalação

Opção 1: Instalar via npm (recomendado para clientes como Cursor/Cline)

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

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

Opção 2: Compilar a partir do código-fonte (para desenvolvedores)

1. Clone este repositório:

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

2. Instale as dependências (pnpm é recomendado, npm é suportado):

pnpm install

3. Compile o projeto:

pnpm run build

4. Desenvolva o projeto (via @modelcontextprotocol/inspector):

pnpm run dev

abra http://localhost:5173

Configuração

Configuração do Servidor MCP

Se você instalou via npm (Opção 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": []
    }
  }
}

Se você compilou a partir do código-fonte (Opção 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": []
    }
  }
}

Configuração de Ambiente

Inicialize as variáveis no seu ambiente:

# 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

Descrição da Configuração

• Descrição do Guia de Uso Link

Estrutura do Projeto

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

Ferramentas Disponíveis

O servidor MCP fornece as seguintes ferramentas do DataWorks:

Veja este link

Considerações de Segurança

• Mantenha sua chave privada segura e nunca a compartilhe
• Use variáveis de ambiente para informações sensíveis
• Monitore e audite regularmente as atividades dos agentes de IA

Solução de Problemas

Se você encontrar problemas:

1. Verifique se a chave de acesso e a chave secreta da API aberta do Aliyun estão corretas
2. Verifique se o ID da região está correto
3. Certifique-se de que está na rede pretendida (mainnet, testnet ou devnet)
4. Verifique se a compilação foi bem-sucedida

Dependências

As principais dependências incluem:

• @alicloud/dataworks-public20240518
• @alicloud/openapi-client

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

1. Faça um fork do repositório
2. Crie sua branch de funcionalidade (git checkout -b feature/amazing-feature)
3. Faça commit das suas alterações (git commit -m 'Add some amazing feature')
4. Envie para a branch (git push origin feature/amazing-feature)
5. Abra um Pull Request

Licença

Este projeto está licenciado sob a Licença Apache 2.0.