Ncloud Gov

io.github.sjk4425由 GitHub 帳號 sjk4425 發布v0.2.1更新於 Oct 27, 2026

DEPRECATED: merged into ncloud-mcp-server (use NCLOUD_ZONE=gov). Ncloud Gov zone MCP server.

已驗證STDIO僅桌面資料庫雲端與基礎設施

概覽

AI 產生的概覽

已棄用的 MCP 伺服器,可用自然語言管理 Naver Cloud Platform 政府雲(Gov)基礎設施,已被 ncloud-mcp-server 取代。

可以做什麼
  • 建立、查詢與管理政府雲運算資源,例如伺服器、區塊儲存、公網 IP、登入金鑰、初始化腳本與自動擴展
  • 管理網路:VPC、網路 ACL、NAT 閘道、路由表、對等連線、負載平衡、目標群組與 DNS
  • 操作代管資料庫(MySQL、PostgreSQL、MSSQL、MongoDB、Redis)、容器映像倉庫與 Kubernetes 服務
  • 處理儲存(NAS、物件儲存、封存儲存)以及開發流水線、安全、分析、CDN、媒體、治理與帳務查詢
  • 在啟用動態載入時於執行期列出並開啟工具群組
適用情境
僅當你已依賴這個特定套件來操作 Naver Cloud 政府雲時使用。新部署應改用合併後的 ncloud-mcp-server 並設定政府雲區域,因為本套件已棄用且不再更新。
執行需求
本機 Node.js 20 或以上版本,透過 npx 或本機建置執行。需要政府雲主控台核發的 API 存取金鑰與私密金鑰,以 NCLOUD_ACCESS_KEY 與 NCLOUD_SECRET_KEY 提供。選用設定包含區域、API 閘道位址、工具群組、逾時與回應裁剪。需要能連線至政府雲 API 閘道網域的網路。
安裝前請注意
此套件已棄用且不再維護,功能與 API 變更只在合併套件中提供;遷移時必須補上政府雲區域設定,否則請求會送往商用區 API 而導致認證失敗。它持有長期有效的 API 憑證,可建立、修改與刪除雲端資源,且尚未在真實政府雲帳號上完整驗證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ncloud Gov,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Ncloud 공공존(Gov) MCP Server

한국어 | English

[!WARNING] 이 패키지는 지원이 중단되었습니다. 공공존 지원은 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 등은 이름과 의미가 같습니다.
diff
 {   "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.0ncloud-mcp-server
ncloud_nks_list_addon_configsncloud_nks_list_available_addons
ncloud_nks_get_addon_configncloud_nks_get_available_addon
ncloud_nks_get_addon_config_versionncloud_nks_get_available_addon_version
ncloud_nks_install_cluster_addonncloud_nks_install_addons
ncloud_nks_update_cluster_addonncloud_nks_update_addon
ncloud_nks_delete_cluster_addonncloud_nks_delete_addon
ncloud_change_fabric_cluster_name / ncloud_change_fabric_cluster_descriptionncloud_update_fabric_cluster (하나로 통합)
ncloud_cdss_restart_cmakncloud_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 기준 문서입니다(보관용).

[CI] [npm] [License: MIT] [Node.js] [TypeScript]

Naver Cloud Platform 공공존(Government Cloud) 인프라를 AI 클라이언트에서 자연어로 생성·조회·관리하는 MCP(Model Context Protocol) 서버입니다.

민간존용 ncloud-mcp-server 를 기반으로 파생한 공공존 전용 프로젝트로, API Gateway 도메인이 *.apigw.gov-ntruss.com 을 사용하도록 구성되어 있습니다. 현재 13개 그룹 · 약 877개 도구를 제공합니다.

지원 서비스

그룹 (key)서비스
commonRegion / Zone (always on)
computeServer, Block Storage, Public IP, Login Key, Init Script, Placement Group, Auto Scaling, ACG, Network Interface, Cloud Functions
networkVPC, Network ACL, NAT Gateway, Route Table, VPC Peering, Load Balancer, Target Group, Global DNS, Global Traffic Manager
databaseCloud DB for MySQL / PostgreSQL / MSSQL / MongoDB / Redis(Cache)
containersContainer Registry (NCR), Kubernetes Service (NKS)
storageNAS, Object Storage (S3 호환), Archive Storage (OpenStack Swift)
devtoolsSource Commit, Source Build, Source Deploy, Source Pipeline
securityCertificate Manager, Private CA, Security Monitoring, KMS (v2.0)
analyticsCloud Hadoop, Search Engine Service, Cloud Data Streaming Service, Cloud Log Analytics
cdnCDN+, Global CDN
mediaVOD Station, One-Click Multi DRM
governanceSub Account, Activity Tracer, Cloud Insight, Resource Manager, WMS
billingList 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에 배포된 패키지를 clone·빌드 없이 바로 실행합니다.

bash
npx -y ncloud-gov-mcp-server

방법 2: 로컬 빌드 (소스에서 직접)

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

MCP 클라이언트 설정 예시

npx 방식

json
{  "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"      }    }  }}

로컬 빌드 방식

json
{  "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 으로 켜면 두 개의 메타 도구가 노출됩니다:

  • 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_REGIONKR리전 코드 (KR 수도권 / KRS 남부권)
NCLOUD_API_URLhttps://ncloud.apigw.gov-ntruss.com기본 API Gateway 도메인
NCLOUD_TOOL_GROUPS(전체 ON)로딩할 그룹. dynamic = 코어 세트 + 런타임 확장 (위 표 참고)
NCLOUD_ARCHIVE_PROJECT_ID—Archive Storage 사용 시 필수 (Keystone project_id). 두 값이 모두 있어야 Archive 도구 등록
NCLOUD_ARCHIVE_DOMAIN_ID—Archive Storage 사용 시 필수 (Keystone domain_id)
NCLOUD_LANGko에러 메시지 언어 (en 지정 시 영문)
NCLOUD_TIMEOUT_MS30000API 요청 타임아웃(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

來源:README.md,提交 f10a821

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

2
  1. v0.2.1最新Oct 2, 2026
  2. v0.2.0Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分