ncloud-gov

Ncloud 公共ゾーン（Gov）MCP サーバー

韓国語 | 英語

警告

このパッケージのサポートは終了しました。 公共ゾーンのサポートは ncloud-mcp-server 2.0+ に統合されています。このパッケージは民間ゾーン・公共ゾーン・金融ゾーンをまとめてサポートします。 ncloud-gov-mcp-server 0.2.x は引き続きインストール・実行できますが、今後の機能追加と API 変更への対応は統合パッケージでのみ行います。

統合パッケージへの移行

1. パッケージを ncloud-gov-mcp-server から ncloud-mcp-server に変更します。
2. NCLOUD_ZONE=gov を追加します。指定しないと民間ゾーンの API が呼び出され、認証エラーが発生します。
3. それ以外の環境変数はそのままにします。公共ゾーンのキー、NCLOUD_REGION（KR/KRS）、NCLOUD_TOOL_GROUPS、NCLOUD_ARCHIVE_PROJECT_ID/NCLOUD_ARCHIVE_DOMAIN_ID などは、名前も意味も同じです。

 {
   "mcpServers": {
     "ncloud-gov": {
       "command": "npx",
-      "args": ["-y", "ncloud-gov-mcp-server"],
+      "args": ["-y", "ncloud-mcp-server"],
       "env": {
+        "NCLOUD_ZONE": "gov",
         "NCLOUD_ACCESS_KEY": "your-gov-access-key",
         "NCLOUD_SECRET_KEY": "your-gov-secret-key",
         "NCLOUD_REGION": "KR"
       }
     }
   }
 }

ツールの違い（0.2.0 → ncloud-mcp-server 2.0.1、NCLOUD_ZONE=gov）

統合パッケージは公共ゾーンで約1,000個のツールを登録します（0.2.0では約900個）。0.2.0のツールのほとんどは名前が同じで、異なるのは以下の30個のみです。

名前が変更されたツール（9個）

0.2.0	ncloud-mcp-server
ncloud_nks_list_addon_configs	ncloud_nks_list_available_addons
ncloud_nks_get_addon_config	ncloud_nks_get_available_addon
ncloud_nks_get_addon_config_version	ncloud_nks_get_available_addon_version
ncloud_nks_install_cluster_addon	ncloud_nks_install_addons
ncloud_nks_update_cluster_addon	ncloud_nks_update_addon
ncloud_nks_delete_cluster_addon	ncloud_nks_delete_addon
ncloud_change_fabric_cluster_name / ncloud_change_fabric_cluster_description	ncloud_update_fabric_cluster（1つに統合）
ncloud_cdss_restart_cmak	ncloud_cdss_restart_cmak_service

提供されないツール（21個）

0.2.0 のツール	理由
CDN+ ncloud_cdnplus_* 5個、Global CDN ncloud_globalcdn_* 5個	2026-12-31にサービス終了予定（新規作成不可）。代わりに Global Edge（ncloud_edge_*）を提供
SES ncloud_ses_get_cluster_detail、get_server_generations、get_server_specs、get_cluster_server_images、get_subnet_list_g3、create_cluster_g3、change_disk_size	公共ゾーンの API ガイドにないオペレーション（民間ゾーン専用の G3/KVM 系統）
CDSS ncloud_cdss_get_server_generations、get_server_spec_list、get_cluster_server_images	公共ゾーンの API ガイドにないオペレーション（民間ゾーン専用の G3 系統）
ncloud_nks_reset_kubeconfig	公共ゾーンの API ガイドにないオペレーション

パラメーターの変更：Cache、Search Engine Service、Cloud Data Streaming Service、Cloud Insight、Container Registry、KMS などの約80個のツールで、公式 API ガイドに合わせてパラメーターが変更されました。AI クライアントはツールのスキーマを自動的に読み込むため、通常は気にする必要はありません。ツール名やパラメーターを直接記述しているスクリプトやプロンプトのみ確認してください。

統合パッケージの公共ゾーンサポートは、公共ゾーンの API ガイドと単体テストで検証済みです。実際の公共ゾーンアカウントではまだテストしていません。問題があれば ncloud-mcp-server のイシューでお知らせください。

---

以下は0.2.x時点のドキュメントです（保管用）。

Naver Cloud Platform 公共ゾーン（Government Cloud） のインフラを、AI クライアントから自然言語で作成・参照・管理する MCP（Model Context Protocol）サーバーです。

民間ゾーン向けの ncloud-mcp-server をベースに派生した公共ゾーン専用プロジェクトで、API Gateway のドメインが *.apigw.gov-ntruss.com を使用するように構成されています。現在、13グループ・約877個のツールを提供しています。

対応サービス

グループ（key）	サービス
common	リージョン／ゾーン（常時有効）
compute	サーバー、ブロックストレージ、パブリック IP、ログインキー、初期化スクリプト、プレースメントグループ、自動スケーリング、ACG、ネットワークインターフェイス、Cloud Functions
network	VPC、ネットワーク ACL、NAT ゲートウェイ、ルートテーブル、VPC ピアリング、ロードバランサー、ターゲットグループ、Global DNS、Global Traffic Manager
database	Cloud DB for MySQL / PostgreSQL / MSSQL / MongoDB / Redis（Cache）
containers	Container Registry（NCR）、Kubernetes Service（NKS）
storage	NAS、Object Storage（S3 互換）、Archive Storage（OpenStack Swift）
devtools	Source Commit、Source Build、Source Deploy、Source Pipeline
security	Certificate Manager、Private CA、Security Monitoring、KMS（v2.0）
analytics	Cloud Hadoop、Search Engine Service、Cloud Data Streaming Service、Cloud Log Analytics
cdn	CDN+、Global CDN
media	VOD Station、One-Click Multi DRM
governance	Sub Account、Activity Tracer、Cloud Insight、Resource Manager、WMS
billing	List Price、Cost and Usage、Discount（料金・コスト・割引の照会）

一部のサービスでは、管理・モニタリングを中心に、主要なエンドポイントのみを優先して提供します（例：VOD Station、Sub Account の IAM 全範囲）。

要件

• Node.js 20 以上
• 公共ゾーンのコンソール（console.gov-ncloud.com）で発行した API 認証キー（Access Key / Secret Key）

インストールと実行

方法 1：npx（推奨 — インストール不要で実行）

npm に公開されているパッケージを、クローンやビルドをせずにそのまま実行します。

npx -y ncloud-gov-mcp-server

方法 2：ローカルビルド（ソースから直接）

git clone https://github.com/sjk4425/ncloud-gov-mcp-server.git
cd ncloud-gov-mcp-server
npm install
npm run build   # dist/ 생성 (prepare 훅으로 install 시 자동 실행)

MCP クライアントの設定例

npx 方式

{
  "mcpServers": {
    "ncloud-gov": {
      "command": "npx",
      "args": ["-y", "ncloud-gov-mcp-server"],
      "env": {
        "NCLOUD_ACCESS_KEY": "your-gov-access-key",
        "NCLOUD_SECRET_KEY": "your-gov-secret-key",
        "NCLOUD_REGION": "KR"
      }
    }
  }
}

ローカルビルド方式

{
  "mcpServers": {
    "ncloud-gov": {
      "command": "node",
      "args": ["/path/to/Ncloud-GOV/dist/index.js"],
      "env": {
        "NCLOUD_ACCESS_KEY": "your-gov-access-key",
        "NCLOUD_SECRET_KEY": "your-gov-secret-key",
        "NCLOUD_REGION": "KR"
      }
    }
  }
}

ツールグループの選択と動的読み込み

NCLOUD_TOOL_GROUPS 環境変数で読み込むグループを制御します。すべてのツールを一度に読み込むとコンテキストが大きくなるため、必要なグループだけを選択するか、実行時に拡張できます。

設定値	動作
（未設定）	すべて ON — 13 グループ、877 個のツールをすべて登録
compute,network	指定したグループ + common のみ登録（ロック — 実行時の変更不可）
all,-database	すべてのグループから特定のグループを除外。除外されたグループは実行時の有効化も禁止
dynamic	コアセット（common + compute + network + database）のみで起動 + 実行時の拡張を許可

動的グループ（dynamic）

NCLOUD_TOOL_GROUPS=dynamic を設定すると、2 つのメタツールが公開されます。

• ncloud_list_tool_groups — グループ一覧・サービス・ツール数・状態（enabled / available / blocked）を取得
• ncloud_enable_tool_group — 必要なグループをセッション中に即時読み込み（例：ストレージの操作を依頼されたときに storage グループを有効化）

起動時はコアグループのみを読み込んでツール数を抑え、AI が必要なサービスに遭遇したときに、そのグループだけを有効化してコンテキストを節約します。グループの有効化時に発生する多数の tools/list_changed 通知は、1 回にまとめて送信されます。

セキュリティ境界：-database のように運用者が明示的に除外したグループは、dynamic モードでも実行時の有効化が拒否されます。

環境変数

変数	必須	デフォルト値	説明
NCLOUD_ACCESS_KEY	✅	—	公共ゾーン API Access Key
NCLOUD_SECRET_KEY	✅	—	公共ゾーン API Secret Key
NCLOUD_REGION		KR	リージョンコード（KR 首都圏 / KRS 南部圏）
NCLOUD_API_URL		https://ncloud.apigw.gov-ntruss.com	デフォルトの API Gateway ドメイン
NCLOUD_TOOL_GROUPS		（すべて ON）	読み込むグループ。dynamic = コアセット + 実行時の拡張（上の表を参照）
NCLOUD_ARCHIVE_PROJECT_ID		—	Archive Storage の使用時に必須（Keystone project_id）。2 つの値が両方ある場合にのみ Archive ツールを登録
NCLOUD_ARCHIVE_DOMAIN_ID		—	Archive Storage の使用時に必須（Keystone domain_id）
NCLOUD_LANG		ko	エラーメッセージの言語（en を指定すると英語）
NCLOUD_TIMEOUT_MS		30000	API リクエストのタイムアウト（ms）

全項目については .env.example を参照してください。

공공존과 민간존의 차이

• 도메인: 대부분의 API Gateway 엔드포인트가 *.apigw.gov-ntruss.com 을 사용합니다 (민간존은 *.apigw.ntruss.com).
• 인증 방식: HMAC-SHA256 서명(x-ncp-apigw-signature-v2 등)으로 민간존과 동일합니다.
• 도메인 예외(기계적 치환 불가): 일부 서비스는 gov에서 다른 도메인/경로를 씁니다. 반드시 공공존 API 문서로 확인:
  • Container Registry: gov-ncr.apigw.gov-ntruss.com (경로 /ncr/{kr|krs}/v2/)
  • Object Storage: {kr|krs}.object.gov-ncloudstorage.com (S3 호환 · AWS SigV4 · 서명 리전 gov-standard/gov2-standard)
  • Archive Storage: kr.archive.gov-ncloudstorage.com (OpenStack Swift · Keystone v3)
  • Private CA: privateca.apigw.gov-ntruss.com (민간존 pca 아님)
  • KMS v2.0: ocapi.gov-ncloud.com (apigw 게이트웨이 아님)
  • VOD Station: vod-station.apigw.gov-ntruss.com (하이픈)
  • NKS / Search Engine / Cloud Data Streaming: 남부권(KRS)은 경로 prefix가 다름 (krs-v2 등)
• 제공 서비스: 공공존은 격리망 특성상 일부 서비스만 제공됩니다. 서비스 추가 전 공공존 API 문서에서 제공 여부를 확인하세요.

검증 상태

• 빌드 & 등록: tsc 빌드 + 단위 테스트 통과. MCP 프로토콜 스모크 테스트로 13개 그룹 877개 도구 등록·중복 없음·동적 활성화 동작 확인.
• 실 API 호출: 공공존 계정으로 각 서비스 엔드포인트를 실제 호출한 검증은 미완료 항목이 있습니다.

라이선스

MIT