Servidor DataWorks MCP

Un servidor de protocolo de contexto de modelo (MCP) que proporciona herramientas para la 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 sin problemas.

Visión general

Este servidor MCP

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

El servidor implementa la especificación Model Context Protocol para estandarizar las interacciones de los recursos en la nube para los agentes de IA.

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)

# Instala globalmente npm install -g alibabacloud-dataworks-mcp-server # O instala localmente en tu proyecto npm install alibabacloud-dataworks-mcp-server

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

1. Clona este repositorio:

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

2. Instale las dependencias (se recomienda pnpm, npm es compatible):

pnpm install

3. Construye el proyecto:

pnpm run build

4. Desarrollar el proyecto (por @modelcontextprotocol/inspector):

pnpm run dev

abrir http://localhost:5173

Configuración

Configuración del servidor MCP

Si ha instalado a través de 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 construyó 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

variables init en su entorno:

# DataWorks Configuración REGION=su_dataworks_open_api_region_id_here ALIBABA_CLOUD_ACCESS_KEY_ID=su_alibaba_cloud_access_key_id ALIBABA_CLOUD_ACCESS_KEY_SECRET=su_alibaba_cloud_access_key_secret TOOL_CATEGORIES=opcional_su_tool_categories_here_ex_SERVER_IDE_DEFAULT TOOL_NAMES=opcional_su_tool_names_here_ex_ListProjects

Configuración Descripción

• Guía de uso Descripción Enlace

Estructura del proyecto

alibabacloud-dataworks-mcp-server/ ├── src/ │ ├── index.ts # Punto de entrada principal ├── package.json └── tsconfig.json

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas de DataWorks:

Consulte este enlace

Consideraciones de seguridad

• Mantenga segura su clave privada y no la comparta nunca
• Utilice variables de entorno para la información sensible
• Supervise y audite regularmente las actividades de los agentes de AI

Solución de problemas

Si tiene problemas

1. Compruebe que su clave de acceso y clave secreta de Aliyun Open API son correctas
2. Compruebe que su identificador de región es correcto
3. Asegúrese de que se encuentra en la red prevista (mainnet, testnet o devnet)
4. Compruebe que la compilación se ha realizado correctamente

Dependencias

Dependencias clave

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

Contribución

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

1. Fork el repositorio
2. Crea tu rama(git checkout -b feature/amazing-feature)
3. Confirme sus cambios(git commit -m 'Añadir alguna característica asombrosa')
4. Empuja a la rama(git push origin feature/amazing-feature)
5. Abrir una Pull Request

Licencia

Este proyecto está bajo la Licencia Apache 2.0.