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 がサポートされています):
- プロジェクトをビルドします。
- プロジェクトの開発 (@modelcontextprotocol/inspector による):
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 ライセンスに基づいてライセンスされます。