HuaweiCloud DevKit (Community Preview)

Name: HuaweiCloud DevKit (Community Preview)
Author: glqff

リモート

github.com/huaweicloudクラウド・インフラ696 日前に更新

リポジトリ

HuaweiCloud DevKit (Community Preview) について

HuaweiCloud DevKit は、AI コーディングエージェントが華為云（Huawei Cloud）をより正確かつ安全に利用できるようにするコミュニティプレビュー版の MCP サーバー兼インストーラーです。複数のエージェントプラットフォームに対応します。

主な機能

01複数のエージェントプラットフォームへのプラグイン一括インストール
02KooCLI コマンドラインツールとの連携
03AK/SK 認証情報設定の単一の入口
04MCP ツールによる実行時のアカウント切り替え
05Hermes 向けの危険なターミナルコマンドを遮断するフック

活用シーン

01コーディングエージェントに華為云の知識と CLI 操作を提供する
02OpenCode や Codex へのプラグインのインストールと状態確認
03MCP に対応した任意のエージェントへの手動登録

MCP 対応

MCP サーバー huaweicloud-devkit-mcp として、華為云関連のツールを stdio またはローカルの Streamable HTTP エンドポイント経由で MCP クライアントに公開します。huaweicloud_auth_init や huaweicloud_auth_switch などの認証ツールも含まれます。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://erx5uqu4-8931.cn-north-4-bridge.myhuaweicloud.com/mcp

インストールコマンドをコピー

Claude CodeTerminalclaude mcp add --transport http glqff-huaweicloud-devkit https://erx5uqu4-8931.cn-north-4-bridge.myhuaweicloud.com/mcp

Cursor.cursor/mcp.json

{"mcpServers":{"glqff-huaweicloud-devkit":{"type":"http","url":"https://erx5uqu4-8931.cn-north-4-bridge.myhuaweicloud.com/mcp"}}}

Cursor で開く

VS Code.vscode/mcp.json

{"servers":{"glqff-huaweicloud-devkit":{"type":"http","url":"https://erx5uqu4-8931.cn-north-4-bridge.myhuaweicloud.com/mcp"}}}

VS Code で開く

Claude Desktopclaude_desktop_config.json

{"mcpServers":{"glqff-huaweicloud-devkit":{"type":"http","url":"https://erx5uqu4-8931.cn-north-4-bridge.myhuaweicloud.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json

{"mcpServers":{"glqff-huaweicloud-devkit":{"serverUrl":"https://erx5uqu4-8931.cn-north-4-bridge.myhuaweicloud.com/mcp"}}}

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

HuaweiCloud DevKit

中文 | English

AI コーディングエージェントが Huawei Cloud を安全かつ正確に利用できるようにします。クラウドのナレッジ、CLI ツール、安全対策をエージェントに提供する統合ソリューションです。

OpenCode、Codex、CodeArts Agent、WorkBuddy、DeepSeek Harness（DSH）、OfficeAce、Hermes、OpenClaw、AtomCode に対応しています。

前提条件

Node.js >= 22

中国本土のユーザー向け：デフォルトの npm レジストリでダウンロードが遅い、または接続に問題がある場合は、Huawei Cloud の npm ミラーを設定してください。
npm config set registry https://mirrors.huaweicloud.com/repository/npm/
デフォルトのレジストリに戻すには、npm config delete registry を実行します。

ミラーの反映遅延：npm ミラー（npmmirror、mirrors.huaweicloud.com）は、新しいリリース後、公式レジストリより数時間遅れることがあります。ETARGET エラーが発生する場合、または古いバージョンがインストールされる場合は、代わりに公式レジストリを使ってインストールしてください。
npx --yes --registry=https://registry.npmjs.org huaweicloud-devkit install --target <target>

クイックスタート

--target を省略すると、インストーラーはマシン上のエージェントを自動検出します。

検出なし：対話型ターミナルでは、インストール先（明示した単一のターゲット／すべて／汎用 MCP エージェントの設定）を選択できます。非対話型シェルでは、サポートされているターゲットの一覧を表示してエラーになります。

1つ検出：そのエージェントに直接インストールします。

複数検出：対話型ターミナルでは複数選択メニューが表示されます。非対話型シェルではエラーになり、--target <agent>／--target all を指定するよう案内されます。一度にすべてをセットアップするには、npx --yes huaweicloud-devkit install --target all を実行してください（Codex は CLI が見つからない場合、スキップされます）。

以下のコマンドはグローバルに適用されます（すべてのエージェントが対象です）。

npx --yes huaweicloud-devkit version  # print CLI version and installed plugin versions per agent
npx --yes huaweicloud-devkit uninstall --target all --clean-global  # also remove KooCLI + OBS config

OpenCode

npx --yes huaweicloud-devkit install --target opencode

インストール後、セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target opencode
npx --yes huaweicloud-devkit status --target opencode
npx --yes huaweicloud-devkit update --target opencode
npx --yes huaweicloud-devkit uninstall --target opencode
rm -rf ~/.npm/_npx/  # Linux/macOS; Windows: rmdir /s /q %LOCALAPPDATA%\npm-cache\_npx

Codex

npx --yes huaweicloud-devkit install --target codex

インストール後、Codex セッションを再起動してください。

codex plugin list  # verify huaweicloud-devkit@huaweicloud-devkit is installed and enabled
npx --yes huaweicloud-devkit doctor --target codex
npx --yes huaweicloud-devkit status --target codex
npx --yes huaweicloud-devkit update --target codex
npx --yes huaweicloud-devkit uninstall --target codex

次に、Codex で @huaweicloud-devkit に言及するか、Huawei Cloud で行いたい作業を直接説明してください。

Codex CLI が必要です — codex コマンドが PATH に含まれている必要があります。Codex が WindowsApps（Microsoft Store）経由でインストールされている場合は、代わりに --target codex-desktop を使ってください。codex --version を実行して、CLI が利用可能か確認してください。

Codex Desktop

Codex CLI が利用できない場合、または Windows で Codex が WindowsApps 経由でインストールされている場合は、このターゲットを使用してください。

npx --yes huaweicloud-devkit install --target codex-desktop

インストール後、Codex Desktop セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target codex-desktop
npx --yes huaweicloud-devkit status --target codex-desktop
npx --yes huaweicloud-devkit update --target codex-desktop
npx --yes huaweicloud-devkit uninstall --target codex-desktop

次に、新しい Codex Desktop タスクで @huaweicloud-devkit に言及するか、Huawei Cloud で行いたい作業を直接説明してください。

CodeArts Agent

npx --yes huaweicloud-devkit install --target codearts

インストール後、セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target codearts
npx --yes huaweicloud-devkit status --target codearts
npx --yes huaweicloud-devkit update --target codearts
npx --yes huaweicloud-devkit uninstall --target codearts

サンドボックスモード：CodeArts はデフォルトでサンドボックスモードになっており、KooCLI がブロックされます。install-hcloud はこの状態を検出して、解決方法を表示します。KooCLI をサンドボックス外のターミナルにインストールするか、CodeArts の設定（Settings → Chats → Agents Terminal Command Running Mode → Auto Running）でサンドボックスモードを無効にしてください。

CodeArts Work

npx --yes huaweicloud-devkit install --target codearts-work

インストール後、セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target codearts-work
npx --yes huaweicloud-devkit status --target codearts-work
npx --yes huaweicloud-devkit update --target codearts-work
npx --yes huaweicloud-devkit uninstall --target codearts-work

CodeArts Work（CodeArts Space、appId：com.codearts.work）は、ユーザーレベルの設定 %USERPROFILE%\.codeartswork\ を使用します。プロジェクトレベルの .codeartswork ディレクトリは作成されません。

WorkBuddy

npx --yes huaweicloud-devkit install --target workbuddy

インストール後、セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target workbuddy
npx --yes huaweicloud-devkit status --target workbuddy
npx --yes huaweicloud-devkit update --target workbuddy
npx --yes huaweicloud-devkit uninstall --target workbuddy

DeepSeek Harness (DSH)

npx --yes huaweicloud-devkit install --target dsh

インストール後、DSH セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target dsh
npx --yes huaweicloud-devkit status --target dsh
npx --yes huaweicloud-devkit update --target dsh
npx --yes huaweicloud-devkit uninstall --target dsh

DSH V1 は、@deepseek-ai/dsh-mcp-client を通じて既存の MCP サーバーを再利用します。インストーラーがクライアントを検出できないと報告した場合は、次を実行してください：npx @deepseek-ai/dsh plugin --profile web add @deepseek-ai/dsh-mcp-client。

OfficeAce

npx --yes huaweicloud-devkit install --target officeace

インストール後、OfficeAce を再起動してください。

npx --yes huaweicloud-devkit doctor --target officeace
npx --yes huaweicloud-devkit status --target officeace
npx --yes huaweicloud-devkit update --target officeace
npx --yes huaweicloud-devkit uninstall --target officeace

Hermes

npx --yes huaweicloud-devkit install --target hermes

インストール後、Hermes セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target hermes
npx --yes huaweicloud-devkit status --target hermes
npx --yes huaweicloud-devkit update --target hermes
npx --yes huaweicloud-devkit uninstall --target hermes

アンインストール時の注意：Linux では、クリーンな状態にするため、アンインストール後に rm -rf ~/.npm/_npx/* && npm cache clean --force を実行してください。Windows では、ファイルロックを解除するため、まず Hermes のセッションをすべて終了してください。アンインストール後は %LOCALAPPDATA%\hermes\config.yaml の YAML が破損していないか確認し、ファイルが残っている場合は %LOCALAPPDATA%\hermes\huaweicloud-plugins を手動で削除してください。 安全フック：インストーラーは Hermes のシェルフック（config.yaml → hooks.pre_tool_call）を設定し、認証情報ファイルの読み取り、環境変数のダンプ、未承認の hcloud 書き込み操作などの安全でないターミナルコマンドをインターセプトします。Hermes は初回に同意を求めるプロンプトを表示します。これを承認するか、config.yaml で hooks_auto_accept: true を設定すると自動的に承認されます。 MCP Python SDK：インストーラーは、Hermes が MCP ツールを検出するために必要な mcp Python パッケージを自動的にインストールします。doctor で [FAIL] Hermes MCP Python SDK と表示された場合は、pip3 install mcp を手動で実行してください。 Windows：docs/hermes-windows.md で既知の問題と回避策を確認してください。

OpenClaw

# Recommended (ClawHub)
openclaw plugins install clawhub:huaweicloud-devkit
openclaw plugins uninstall huaweicloud-devkit
openclaw plugins update huaweicloud-devkit

インストール後、OpenClaw を再起動してください。セキュリティリスクの確認を求められた場合は、--acknowledge-clawhub-risk を追加してください。

# Or via npx
npx --yes huaweicloud-devkit install --target openclaw
npx --yes huaweicloud-devkit status --target openclaw
npx --yes huaweicloud-devkit update --target openclaw
npx --yes huaweicloud-devkit uninstall --target openclaw
rm -rf ~/.npm/_npx/  # Linux/macOS; Windows: rmdir /s /q %LOCALAPPDATA%\npm-cache\_npx

AtomCode

npx --yes huaweicloud-devkit install --target atomcode

インストール後、AtomCode セッションを再起動してください。

npx --yes huaweicloud-devkit doctor --target atomcode
npx --yes huaweicloud-devkit status --target atomcode
npx --yes huaweicloud-devkit update --target atomcode
npx --yes huaweicloud-devkit uninstall --target atomcode

その他のエージェント

MCP をサポートするエージェントであれば、標準設定を使用できます。

{
  "mcpServers": {
    "huaweicloud-devkit": {
      "command": "npx",
      "args": ["-y", "-p", "huaweicloud-devkit", "huaweicloud-devkit-mcp"]
    }
  }
}

インストールは不要です。すべて npx が処理します。

このような手動の MCP 登録では、認証情報を設定に記載しないでください。HW_ACCESS_KEY／HW_SECRET_KEY はプラットフォーム／CI によって注入されるアカウント（例：DevSpace が管理するデフォルトアカウント）用に予約されています。npx huaweicloud-devkit auth init（唯一のエントリーポイント）でご自身のアカウントを設定し、実行時に huaweicloud_auth_init／huaweicloud_auth_switch MCP ツールでアカウントを切り替えてください。認証情報の解決優先順位の詳細は、plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/SKILL.md を参照してください。

リモート（HTTP）経由で接続する

エージェントが stdio ではなく type: "remote"（Streamable HTTP）をサポートしている場合は、まず devkit リモート MCP サーバーをローカルで起動してください。

npx --yes huaweicloud-devkit-mcp --transport remote

デフォルトでは 127.0.0.1:9528 でリッスンします。次に、リモート設定で接続してください（opencode の例）。

{
  "mcp": {
    "huaweicloud-devkit": {
      "type": "remote",
      "url": "http://localhost:9528",
      "enabled": true,
    },
  },
}

9528 が使用中の場合は --port <port> を使用し、それに応じて url を更新してください。LAN からアクセスするには --host 0.0.0.0 を追加してください。リモートサーバーには組み込みの認証機能がありません。匿名のままパブリックインターネットに公開しないでください。

KooCLI をインストールする

npx --yes huaweicloud-devkit install-hcloud

認証情報の設定

npx --yes huaweicloud-devkit auth init

AK/SK を KooCLI、OBS、サンドボックス API に一度に同期します。これが唯一のエントリーポイントです。エージェントやシェルの設定に AK/SK をハードコードしないでください。

実行時のアカウント切り替え（エージェントセッション内）：MCP ツール huaweicloud_auth_init（メモリ内で設定され、優先度が最も高い）または huaweicloud_auth_switch（アクション：temporary ／ persist ／ clear）を使用します。HW_ACCESS_KEY ／ HW_SECRET_KEY を介してデフォルトアカウントが注入されるサンドボックス／DevSpace 環境では、通常の auth init ではそのアカウントを上書きできません。セッションのアカウントを優先するには、huaweicloud_auth_switch action=persist を使用してください。

認証情報の解決優先順位（上が最優先）：

#	ソース	設定方法
1	実行時（セッション）の認証情報	`huaweicloud_auth_init` ／ `huaweicloud_auth_switch action=temporary`
2	`configuredBySession: true` を含む S1 グローバルファイル	`huaweicloud_auth_switch action=persist`
3	環境変数（`HW_ACCESS_KEY` ／ `HW_SECRET_KEY`）	プラットフォーム／DevSpace によって注入されるデフォルトアカウント
4	CodeArts ／ CodeArts Work	`.codeartsdoer/mcp/mcp_settings.json` ／ `.codeartswork/mcp/mcp_settings.json`
5	S1 グローバルファイル（セッションフラグなし）	`auth init`
6	KooCLI プロファイル	`~/.hcloud/config.json`（KooCLI コマンドのみ）

セキュリティ：独自の AK/SK を MCP 設定の env フィールドに記述しないでください。平文で保存され、設定ファイルを git にコミットした場合に漏えいするおそれがあります。env はプラットフォーム／CI による注入専用です。

詳細：plugins/huaweicloud-core/skills/huaweicloud-cli-and-auth/SKILL.md。

すべてのエージェントをインストール

npx --yes huaweicloud-devkit install --target all

すべてのエージェントを更新

npx --yes huaweicloud-devkit@latest version
npx --yes huaweicloud-devkit@latest update --target all

update は増分更新です。設定には触れず、インストール済みのファイルを更新します。npm がローカルにキャッシュされた古いバージョンではなく、最新バージョンを取得できるように、常に @latest を指定してください。

プロキシを設定

npx --yes huaweicloud-devkit proxy init    # configure proxy (interactive)
npx --yes huaweicloud-devkit proxy show    # show effective proxy settings
npx --yes huaweicloud-devkit proxy clear   # remove proxy configuration

Huawei Cloud サービスへの接続用に HTTP/HTTPS プロキシを設定します（企業イントラネット環境など）。設定は ~/.config/huaweicloud/proxy.json に保存されます。

環境変数 HTTPS_PROXY、HTTP_PROXY、NO_PROXY はファイルの設定より優先されます。実際に有効な設定を確認するには、proxy show を使用してください。

テレメトリー

HuaweiCloud DevKit は、利用パターンを把握し、プラグインを改善するために匿名のテレメトリーを収集します。テレメトリーはデフォルトで有効です。

収集する情報

インストール ID — マシンフィンガープリント（ホスト名 + MAC アドレス + OS の種類 + ホームディレクトリ）から生成された SHA-256 ハッシュです。生の値が送信または保存されることはありません。
ユーザーハッシュ — Huawei Cloud バックエンドの check-user / generatorUserIDHash API が生成するユーザー識別子のハッシュです。ローカルにキャッシュされ、すべてのイベントとともに送信されます。ローカルの PII から生成されるものではありません。
プラグインのバージョン — インストールされている huaweicloud-devkit のバージョンです。
エージェントハーネス — 実行中の AI コーディングエージェント（例：opencode、codex、codearts）です。
エージェントのバージョン — エージェントのバージョン文字列です。
OS の種類とバージョン — 例：Linux、Darwin、Windows_NT。
機能 — イベントのトリガー方法です。イベントキーから判定される mcp（MCP ツールの呼び出し）または cli（CLI コマンド）です。
イベントの種類 — 発生した内容です。例：plugin:install、plugin:first_use、dau:active_today（日次アクティブ）、tool:<tool_name>、skill:retrieve、sandbox:connect。
イベント値 — サニタイズされた短い文字列（最大 255 文字。改行とタブは削除）です。ツールイベントの場合、通常は 1 です。スキルの取得の場合はスキル名です。

収集しない情報

AK/SK、アクセスキー、その他の認証情報
ユーザー入力、プロンプト、コードの内容
IP アドレス
個人を特定できる情報（PII）
ファイルパス、プロジェクト名

データの送信方法

イベントはメモリ内でキューに入れられ、60 秒ごとに最大 100 件ずつまとめて、HTTP POST で Huawei Cloud のテレメトリエンドポイントに送信されます。送信時にはプロキシ設定が適用されます。リクエストに失敗した場合、最大 3 回再試行され、その後破棄されます。

テレメトリの無効化（オプトアウト）

次の環境変数を設定します。

export HUAWEICLOUD_DEVKIT_TELEMETRY=off

off に設定すると、テレメトリイベントは収集も送信もされません。

デバッグモード

トラブルシューティングのためにテレメトリの動作をログに記録するには、次のように設定します。

export HUAWEICLOUD_DEVKIT_DEBUG=true

デバッグログは、プラグインの telemetry/telemetry-debug.log ファイルに書き込まれます。

できること

クラウド操作のガイド — エージェントに、よく利用される 20 以上の Huawei Cloud サービス（ECS、OBS、VPC、RDS、GaussDB、FunctionGraph、APIG、CCE など）の手順を追ったガイダンスを提供します。
安全性を優先した実行 — すべての書き込み操作で明示的なユーザー承認が必要です。出力から認証情報とシークレットが自動的にマスキングされます。
実行前のリスクチェック — 公開状態への露出、認証情報の漏えい、破壊的な操作を実行前に検出します。
リージョンへの対応 — 利用可能なリージョンを自動検出し、リソース作成前にサービスの利用可否を確認します。
サンドボックス（DevStation） — Web アプリをデプロイし、公開 URL をすぐにプレビューできる一時的なクラウドランタイムです。

対応サービス

ECS、OBS、VPC、IAM、RDS、GaussDB、FunctionGraph、APIG、CCE、SMN/DMS、ModelArts、Cloud Eye、CTS、DEW、Billing、CBR、WAF/AAD、DDS/DCS、Deployment、および入門ガイド。

上記はあらかじめ設定されたガイダンスの一覧です。残りの 200 以上の Huawei Cloud サービスも、 KooCLI / API / SDK のルーティング経由で引き続き利用できます（capability-discovery と cli-and-auth のメタスキルを参照してください）。

ドキュメント

コントリビューター

ライセンス

このプロジェクトは Apache-2.0 ライセンスのもとでライセンスされています。詳細は LICENSE をご覧ください。

Markdown 対応

ログインしてコメント

基本情報

作者: glqff
バージョン: 1.1.1
トランスポート: streamable-http
掲載日: 2026年9月10日
最終更新: 6 日前
公式 Registry: io.github.glqff/huaweicloud-devkit

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

HuaweiCloud DevKit (Community Preview)

HuaweiCloud DevKit (Community Preview) について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

HuaweiCloud DevKit

前提条件

クイックスタート

OpenCode

Codex

Codex Desktop

CodeArts Agent

CodeArts Work

WorkBuddy

DeepSeek Harness (DSH)

OfficeAce

Hermes

OpenClaw

AtomCode

その他のエージェント

リモート（HTTP）経由で接続する

KooCLI をインストールする

認証情報の設定

すべてのエージェントをインストール

すべてのエージェントを更新

プロキシを設定

テレメトリー

収集する情報

収集しない情報

データの送信方法

テレメトリの無効化（オプトアウト）

デバッグモード

できること

対応サービス

ドキュメント

コントリビューター

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？