DataWorks MCP サーバー

AI向けツールを提供するモデルコンテキストプロトコル（MCP）サーバー。標準化されたインターフェースを介してDataWorks Open APIとの連携を可能にします。この実装はAliyun Open APIに基づいており、AIエージェントがクラウドリソースをシームレスに操作できるようにします。

概要

この MCP サーバー:

DataWorks オープン API と対話する
DataWorksリソースを管理する

サーバーは、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: ソースからビルドする（開発者向け）

このリポジトリをクローンします:

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

依存関係をインストールします (pnpm が推奨され、npm がサポートされています):

pnpm install

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

pnpm run build

プロジェクトの開発 (@modelcontextprotocol/inspector による):

pnpm run dev

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エージェントの活動を定期的に監視および監査する

トラブルシューティング

問題が発生した場合:

Aliyun Open APIのアクセスキーとシークレットキーが正しいことを確認してください
地域IDが正しいことを確認してください
目的のネットワーク（メインネット、テストネット、または devnet）に接続していることを確認します
ビルドが成功したことを確認する

依存関係

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

貢献

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

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

このプロジェクトは、Apache 2.0 ライセンスに基づいてライセンスされます。

DataWorks MCP Server

Integrations