ncloud-gov

Ncloud 公共区（Gov）MCP 服务

韩语 | English

警告

此软件包已停止维护。 公共区支持已整合到 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（合并为一个）
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 的文档（存档）。

这是一个 MCP（Model Context Protocol）服务，可让 AI 客户端通过自然语言创建、查询和管理 Naver Cloud Platform 公共区（Government Cloud）基础设施。

这是基于面向民间区的 ncloud-mcp-server 派生的公共区专用项目，其配置使用 *.apigw.gov-ntruss.com 作为 API Gateway 域名。目前提供 13 个分组 · 约 877 个工具。

支持的服务

分组（key）	服务
common	Region / Zone（始终启用）
compute	Server、Block Storage、Public IP、Login Key、Init Script、Placement Group、Auto Scaling、ACG、Network Interface、Cloud Functions
network	VPC、Network ACL、NAT Gateway、Route Table、VPC Peering、Load Balancer、Target Group、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 环境变量控制要加载的分组。一次性加载所有工具会增大上下文，因此可以只选择所需分组，或在运行时扩展。

配置值	行为
（未设置）	全部开启——注册 13 个分组的全部 877 个工具
compute,network	仅注册指定分组和 common（锁定——无法在运行时更改）
all,-database	从全部分组中排除指定分组。被排除的分组也会被禁止在运行时启用
dynamic	仅启动核心集合（common + compute + network + database）+ 允许在运行时扩展

动态分组（dynamic）

通过 NCLOUD_TOOL_GROUPS=dynamic 启用后，会显示两个元工具：

• ncloud_list_tool_groups ——查询分组列表、服务、工具数量和状态（enabled / available / blocked）
• ncloud_enable_tool_group ——在会话期间即时加载所需分组（例如，收到存储操作请求时启用 storage 分组）

启动时仅加载核心分组以减少工具数量；当 AI 需要使用某项服务时，再启用相应分组以节省上下文。启用分组时产生的大量 tools/list_changed 通知会合并为一条发送。

安全边界：对于像 -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		（全部开启）	要加载的分组。dynamic = 核心集合 + 运行时扩展（参见上表）
NCLOUD_ARCHIVE_PROJECT_ID		—	使用 Archive Storage 时必填（Keystone project_id）。必须同时提供两个值才会注册 Archive 工具
NCLOUD_ARCHIVE_DOMAIN_ID		—	使用 Archive Storage 时必填（Keystone domain_id）
NCLOUD_LANG		ko	错误消息语言（指定 en 时使用英文）
NCLOUD_TIMEOUT_MS		30000	API 请求超时时间（毫秒）

完整列表请参阅 .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