DataWorks MCP Server

DataWorks Agent を試す

手動で MCP を設定せずに、すぐに使える DataWorks の AI 体験をお求めですか？

DataWorks Agent は、データ開発と運用のための Alibaba Cloud 組み込みインテリジェントアシスタントです。DataWorks ワークスペースにすぐに接続できるため、ローカルの MCP サーバーを設定することなく、自然言語を使ってメタデータの検索、ノードの開発、タスクのトラブルシューティング、リソースの管理を行えます。

	DataWorks Agent	この MCP サーバー
最適な用途	DataWorks コンソールですぐに利用	カスタム AI クライアント（Cursor、Cline など）
セットアップ	ブラウザーで開いて利用	インストールし、AK を設定して MCP に接続
統合	DataWorks ネイティブの体験	MCP プロトコル経由の Open API

👉 使い始める： https://dataworks.data.alibabacloud.com/product/agent?source=github

DataWorks MCP サーバー

AI が標準化されたインターフェースを介して DataWorks Open API とやり取りするためのツールを提供する、Model Context Protocol（MCP）サーバーです。この実装は Aliyun Open API に基づいており、AI エージェントがクラウドリソースの操作をシームレスに行えるようにします。

DataWorks の機能を独自の AI ワークフローや IDE に組み込みたい場合は、以下のインストールガイドに従ってください。

概要

この MCP サーバーでは、次のことができます。

• DataWorks Open API と連携する
• DataWorks リソースを管理する

このサーバーは Model Context Protocol の仕様を実装し、AI エージェントによるクラウドリソースとのやり取りを標準化します。

前提条件

• Node.js（v16 以降）
• pnpm（推奨）、npm、または yarn
• アクセスキーとシークレットキーを使用する DataWorks Open API

インストール

オプション 1：npm からインストール（Cursor／Cline などのクライアントに推奨）

# Install globally
npm install -g alibabacloud-dataworks-mcp-server

# Or install locally in your project
npm install alibabacloud-dataworks-mcp-server

オプション 2：ソースからビルド（開発者向け）

1. このリポジトリをクローンします。

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

2. 依存関係をインストールします（pnpm を推奨、npm も使用できます）。

pnpm install

3. プロジェクトをビルドします。

pnpm run build

4. プロジェクトを開発します（@modelcontextprotocol/inspector を使用）。

pnpm run dev

open http://localhost:5173

設定

MCP サーバーの設定

npm からインストールした場合（オプション 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": []
    }
  }
}

ソースからビルドした場合（オプション 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": []
    }
  }
}

環境の設定

環境変数を初期化します。

# 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

設定の説明

• ガイドの説明を参照してください。リンク

プロジェクト構成

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

利用可能なツール

MCP サーバーは、以下の DataWorks ツールを提供します。

こちらのリンクを参照してください。

セキュリティに関する考慮事項

• 秘密鍵を安全に保管し、決して共有しないでください
• 機密情報には環境変数を使用してください
• AI エージェントのアクティビティを定期的に監視、監査してください

トラブルシューティング

問題が発生した場合は、次の点を確認してください。

1. Aliyun Open API のアクセスキーとシークレットキーが正しいことを確認します
2. リージョン ID が正しいことを確認します
3. 想定したネットワーク（メインネット、テストネット、または開発ネットワーク）を使用していることを確認します
4. ビルドが正常に完了したことを確認します

依存関係

主な依存関係は次のとおりです。

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

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは Apache 2.0 ライセンスの下でライセンスされています。