DataWorks MCP Server

oficial

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para IA, permitiéndole interactuar con la API abierta de DataWorks a través de una interfaz estandarizada. Esta implementación se basa en la API abierta de Aliyun y permite a los agentes de IA realizar operaciones de recursos en la nube de manera fluida.

GitHub

Documentación

Prueba DataWorks Agent

¿Quieres una experiencia de IA lista para usar en DataWorks sin configuración manual de MCP?

DataWorks Agent es el asistente inteligente integrado de Alibaba Cloud para el desarrollo y operaciones de datos. Se conecta a tu espacio de trabajo de DataWorks de forma inmediata, para que puedas usar lenguaje natural para explorar metadatos, desarrollar nodos, solucionar problemas en tareas y gestionar recursos, sin necesidad de configurar un servidor MCP local.

	DataWorks Agent	Este servidor MCP
Ideal para	Inicio rápido en la consola de DataWorks	Clientes de IA personalizados (Cursor, Cline, etc.)
Configuración	Abrir y usar en el navegador	Instalar, configurar AK y conectar MCP
Integración	Experiencia nativa de DataWorks	API abierta mediante protocolo MCP

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

Servidor MCP de DataWorks

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para IA, permitiéndole interactuar con la API abierta de DataWorks a través de una interfaz estandarizada. Esta implementación se basa en la API abierta de Aliyun y permite a los agentes de IA realizar operaciones en recursos de la nube sin problemas.

Si prefieres integrar las capacidades de DataWorks en tu propio flujo de trabajo de IA o IDE, sigue la guía de instalación a continuación.

Descripción general

Este servidor MCP:

Interactúa con la API abierta de DataWorks
Gestiona recursos de DataWorks

El servidor implementa la especificación del Protocolo de Contexto de Modelo para estandarizar las interacciones de los agentes de IA con los recursos de la nube.

Requisitos previos

Node.js (v16 o superior)
pnpm (recomendado), npm o yarn
API abierta de DataWorks con clave de acceso y clave secreta

Instalación

Opción 1: Instalar desde 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

Opción 2: Compilar desde el código fuente (para desarrolladores)

Clona este repositorio:

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

Instala las dependencias (se recomienda pnpm, se admite npm):

pnpm install

Compila el proyecto:

pnpm run build

Desarrolla el proyecto (mediante @modelcontextprotocol/inspector):

pnpm run dev

abre http://localhost:5173

Configuración

Configuración del servidor MCP

Si instalaste mediante npm (Opción 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": []
    }
  }
}

Si compilaste desde el código fuente (Opción 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": []
    }
  }
}

Configuración del entorno

Inicializa las variables en tu entorno:

# 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

Descripción de la configuración

Descripción de la guía de uso Enlace

Estructura del proyecto

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

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas de DataWorks:

Consulta este enlace

Consideraciones de seguridad

Mantén tu clave privada segura y nunca la compartas
Usa variables de entorno para información sensible
Supervisa y audita regularmente las actividades de los agentes de IA

Solución de problemas

Si encuentras problemas:

Verifica que tu clave de acceso y clave secreta de la API abierta de Aliyun sean correctas
Comprueba que el ID de región sea correcto
Asegúrate de estar en la red prevista (mainnet, testnet o devnet)
Verifica que la compilación haya sido exitosa

Dependencias

Las dependencias clave incluyen:

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Pull Request.

Haz un fork del repositorio
Crea tu rama de funcionalidad (git checkout -b feature/amazing-feature)
Confirma tus cambios (git commit -m 'Add some amazing feature')
Sube la rama (git push origin feature/amazing-feature)
Abre una Pull Request

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0.