Servidor MCP de DataWorks

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

Descripción general

Este servidor MCP:

• Interactúe con la API abierta de DataWorks

• Administrar recursos de DataWorks

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

Related MCP server: DolphinScheduler MCP Server

Prerrequisitos

• 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: Construir desde la fuente (para desarrolladores)

1. Clonar este repositorio:

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

2. Instalar dependencias (se recomienda pnpm, se admite npm):

pnpm install

3. Construir el proyecto:

pnpm run build

4. Desarrollo del proyecto (por @modelcontextprotocol/inspector):

pnpm run dev

abrir http://localhost:5173

Configuración

Configuración del servidor MCP

Si lo instaló 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 lo compiló desde la 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 de inicio en su 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

• Guía de uso Descripción 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 DataWorks:

Ver este enlace

Consideraciones de seguridad

• Mantenga su clave privada segura y nunca la comparta

• Utilice variables de entorno para información confidencial

• Supervisar y auditar periódicamente las actividades de los agentes de IA

Solución de problemas

Si encuentra problemas:

1. Verifique que su clave de acceso y clave secreta de Aliyun Open API sean correctas

2. Comprueba que tu ID de región sea correcta

3. Asegúrese de estar en la red deseada (red principal, red de prueba o red de desarrollo)

4. Verificar que la compilación fue exitosa

Dependencias

Las dependencias clave incluyen:

• @alicloud/dataworks-public20240518

• @alicloud/cliente-openapi

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia Apache 2.0.