DataWorks MCP Server

Un servidor Model Context Protocol (MCP) que ofereix eines per a la IA, permetent que interactuï amb l’API oberta de DataWorks a través d’una interfície estandarditzada. Aquesta implementació es basa en l’API oberta d’Aliyun i permet que els agents d’IA realitzin operacions de recursos en el núvol sense problemes.

Visió general

Aquest servidor MCP:

• Interactua amb l’API oberta de DataWorks
• Gestiona recursos de DataWorks

El servidor implementa la especificació Model Context Protocol per estandarditzar les interaccions amb recursos en el núvol per a agents d’IA.

Requisits previos

• Node.js (v16 o superior)
• pnpm (recomanat), npm o yarn
• DataWorks Open API amb clau d’accés i clau secreta

Instal·lació

Opció 1: Instal·lar des de npm (recomanat per clients com Cursor/Cline)

# Instal·lar globalment
npm install -g alibabacloud-dataworks-mcp-server

# O instal·lar localment al teu projecte
npm install alibabacloud-dataworks-mcp-server

Opció 2: Construir des del codi font (per a desenvolupadors)

1. Clonar aquest repositori:

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

2. Instal·lar dependències (recomanat pnpm, npm també és compatible):

pnpm install

3. Construir el projecte:

pnpm run build

4. Desenvolupar el projecte (per @modelcontextprotocol/inspector):

pnpm run dev

obrir http://localhost:5173

Configuració

Configuració del servidor MCP

Si has instal·lat amb npm (Opció 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 has construït des del codi font (Opció 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ó de l’entorn

Inicialitzar variables a l’entorn:

# Configuració de DataWorks
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ó de la configuració

• Guia d’ús Enllaç

Estructura del projecte

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

Eines disponibles

El servidor MCP ofereix les següents eines de DataWorks:

Veure aquest enllaç

Consideracions de seguretat

• Mantenir la clau privada segura i no compartir-la
• Utilitzar variables d’entorn per a informació sensible
• Monitoritzar i auditar regularment les activitats dels agents d’IA

Resolució de problemes

Si trobes problemes:

1. Verifica que la clau d’accés i la clau secreta d’Aliyun Open API siguin correctes
2. Comprova que l’identificador de regió sigui correcte
3. Assegura’t que estàs a la xarxa prevista (mainnet, testnet o devnet)
4. Verifica que la construcció hagi estat exitosa

Dependències

Les dependències clau inclouen:

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

Contribució

Les contribucions són benvingudes! Si us plau, envia una Pull Request.

1. Forkar el repositori
2. Crear la branca de la teva funcionalitat (git checkout -b feature/amazing-feature)
3. Cometer els canvis (git commit -m 'Add some amazing feature')
4. Empènyer a la branca (git push origin feature/amazing-feature)
5. Obrir una Pull Request

Llicència

Aquest projecte està llicenciat sota la Llicència Apache 2.0.