Serveur DataWorks MCP

Un serveur Model Context Protocol (MCP) qui fournit des outils pour l'IA, lui permettant d'interagir avec l'API ouverte de DataWorks par le biais d'une interface standardisée. Cette implémentation est basée sur l'API ouverte Aliyun et permet aux agents d'intelligence artificielle d'effectuer des opérations sur les ressources en nuage de manière transparente.

Vue d'ensemble

Ce serveur MCP :

• Interagir avec l'API ouverte de DataWorks
• Gérer les ressources DataWorks

Le serveur met en œuvre la spécification Model Context Protocol afin de normaliser les interactions avec les ressources en nuage pour les agents d'intelligence artificielle.

Conditions préalables

• Node.js (v16 ou supérieur)
• pnpm (recommandé), npm ou yarn
• DataWorks Open API avec clé d'accès et clé secrète

Installation

Option 1 : Installation à partir de npm (recommandé pour les clients comme Cursor/Cline)

# Installer globalement npm install -g alibabacloud-dataworks-mcp-server # Ou installer localement dans votre projet npm install alibabacloud-dataworks-mcp-server

Option 2 : Construire à partir des sources (pour les développeurs)

1. Clonez ce dépôt :

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

2. Installez les dépendances (pnpm est recommandé, npm est supporté) :

pnpm install

3. Construire le projet :

pnpm run build

4. Développer le projet (par @modelcontextprotocol/inspector) :

pnpm run dev

ouvrir http://localhost:5173

Configuration du serveur

Configuration du serveur MCP

Si vous avez installé via npm (Option 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 vous avez construit à partir des sources (Option 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" : [] } } }

Configuration de l'environnement

variables d'initialisation dans votre environnement :

# DataWorks Configuration REGION=votre_dataworks_open_api_region_id_here ALIBABA_CLOUD_ACCESS_KEY_ID=votre_alibaba_cloud_access_key_id ALIBABA_CLOUD_ACCESS_KEY_SECRET=votre_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

Configuration Description

• Guide d'utilisation Description Lien

Structure du projet

alibabacloud-dataworks-mcp-server/ ├── src/ │ ├── index.ts # Point d'entrée principal ├── package.json └─── tsconfig.json

Outils disponibles

Le serveur MCP fournit les outils DataWorks suivants :

Voir ce lien

Considérations relatives à la sécurité

• Gardez votre clé privée en sécurité et ne la partagez jamais
• Utilisez des variables d'environnement pour les informations sensibles
• Surveillez et vérifiez régulièrement les activités de l'agent AI

Résolution des problèmes

Si vous rencontrez des problèmes :

1. Vérifiez que votre clé d'accès à l'API ouverte d'Aliyun et votre clé secrète sont correctes
2. Vérifiez que l'identifiant de votre région est correct
3. Vérifiez que vous êtes sur le réseau prévu (mainnet, testnet ou devnet)
4. Vérifiez que la construction a réussi

Dépendances

Les principales dépendances sont les suivantes :

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

Contribuer

Les contributions sont les bienvenues ! N'hésitez pas à soumettre une Pull Request.

1. Créer un dépôt (Fork)
2. Créez votre branche(git checkout -b feature/amazing-feature)
3. Livrez vos changements(git commit -m 'Add some amazing feature')
4. Pousser vers la branche(git push origin feature/amazing-feature)
5. Ouvrir une Pull Request

Licence

Ce projet est sous licence Apache 2.0.