
Ncloud
io.github.sjk4425由 GitHub 帳號 sjk4425 發布v2.2.0更新於 Nov 11, 2026
MCP server for Naver Cloud Platform (Ncloud) — Public, Government and Financial zones
概覽
用來管理 Naver Cloud Platform(Ncloud)基礎設施的 MCP 伺服器,涵蓋公眾、政府與金融專區,提供超過 1000 個 API 工具。
- 可以做什麼
- 建立與檢視運算資源,例如伺服器、區塊儲存、快照、公網 IP、登入金鑰與自動擴展
- 管理網路:VPC、子網、ACG、NAT 閘道、路由表、負載平衡器、目標群組與 DNS
- 維運代管資料庫(MySQL、PostgreSQL、MSSQL、MongoDB、Cache)以及物件儲存、NAS、封存儲存
- 操作容器、Kubernetes 叢集與容器映像倉庫
- 處理安全與監控服務,包括憑證管理員、KMS、Secret Manager、Cloud Insight 與日誌分析
- 查詢帳單、價格與用量,並使用開發工具流水線、分析、媒體與訊息服務
- 適用情境
- 適合想用自然語言查看或操作 Naver Cloud Platform 資源、不必開控制台的情境,尤其是日常查詢、資源建立與跨服務檢查。也適合需要在公眾、政府或金融專區共用同一套工具的團隊。
- 執行需求
- 透過 npx 在本機執行,需要 Node.js 20 以上版本。需要由對應專區主控台核發的 Ncloud API 憑證,以 NCLOUD_ACCESS_KEY 與 NCLOUD_SECRET_KEY 提供。可選設定包括專區(NCLOUD_ZONE)、區域(NCLOUD_REGION)、工具群組、逾時與回應裁剪。需要能連線至 Ncloud API 閘道的網路。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Ncloud,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
Ncloud MCP Server
[CI] [npm version] [License: MIT] [Node.js] [TypeScript]
Naver Cloud Platform(Ncloud) 인프라를 AI 어시스턴트에서 직접 관리할 수 있는 Model Context Protocol (MCP) 서버입니다.
민간존(Public)·공공존(Government)·금융존(Financial)을 하나의 서버로 지원합니다. NCLOUD_ZONE=gov 또는 NCLOUD_ZONE=fin 한 줄로 해당 존의 API 게이트웨이·리전·서비스 카탈로그로 전환되며, 미설정 시 민간존입니다 → 존 선택.
주요 기능
Ncloud의 60개 이상 서비스, 1,000개 이상 API 도구를 MCP 프로토콜로 제공합니다.
ℹ️ 각 카테고리는
NCLOUD_TOOL_GROUPS의 그룹 key와 1:1로 대응합니다. 도구 일부만 로딩하려면 아래 도구 그룹 선택 표를 참고하세요. 🅿 = 민간존 전용(공공존·금융존 API 가이드에 없음) · ⓖ = 공공존 미제공 · ⓕ = 금융존 미제공. 존별 세부 차이는 존 선택의 표를 참고하세요.
모든 도구에 MCP 표준 tool annotations(readOnlyHint/destructiveHint/idempotentHint)이 부여되어, 지원 클라이언트에서 조회 도구 자동 승인·파괴적 도구 확인 UX를 적용할 수 있습니다. 파괴적 도구의 confirm 파라미터 게이트는 그대로 유지됩니다(이중 방어).
사전 요구사항
- Node.js 20 이상
- Ncloud API 인증키 (포털에서 발급)
참고 사항
- 민간존(Public)·공공존(Government)·금융존(Financial) 을 지원합니다.
NCLOUD_ZONE으로 선택하며, 인증키는 반드시 해당 존 콘솔에서 발급한 것을 써야 합니다. - API 스펙은 민간존 API 가이드, 공공존 API 가이드, 금융존 API 가이드를 기반으로 작성되었으며, 존별 엔드포인트·리전·오퍼레이션 차이는 세 가이드를 대조해 반영했습니다.
- 민간존 한국(KR) 리전 위주로 실계정 테스트되었습니다. 공공존·금융존 지원은 각 존의 공식 API 가이드 대조와 단위 테스트로 검증되었으며 아직 실계정으로 확인되지 않았습니다 — 공공존·금융존에서 문제가 있으면 이슈로 알려 주세요. 다른 리전·존에서는 일부 API의 동작이 다를 수 있습니다.
설치
npx (권장 — 설치 불필요)
별도 설치 없이 npx로 바로 실행할 수 있습니다:
MCP 클라이언트 설정 방법은 아래 MCP 클라이언트 설정 섹션을 참고하세요.
소스에서 빌드
환경 변수
존 선택 (민간존 / 공공존 / 금융존)
하나의 패키지로 세 존을 지원합니다. NCLOUD_ZONE만 바꾸면 API 게이트웨이 도메인, 리전 카탈로그, 존별 서비스 카탈로그, 일부 서비스의 API 버전·경로·필드 차이까지 서버가 알아서 맞춥니다. 도구 이름과 파라미터는 세 존에서 동일하므로 프롬프트를 바꿀 필요가 없습니다.
도구 수는
NCLOUD_ARCHIVE_PROJECT_ID/NCLOUD_ARCHIVE_DOMAIN_ID미설정 기준입니다. 설정하면 Archive Storage 도구 10개가 민간존·공공존에 추가됩니다.
⚠️ 인증키는 존별로 별개입니다. 민간존 키로 공공존·금융존을 호출하면(또는 그 반대) 인증 오류가 납니다.
NCLOUD_ZONE에pub/gov/fin외의 값을 주면 다른 존으로 조용히 가지 않도록 서버가 시작 시 종료합니다.
🔑 계정·키 관련 주의 (2.0.0)
- Certificate Manager 2.0 (
ncloud_cm2_*, 민간존)은 메인 계정 Access Key로만 호출됩니다(Ncloud 기술지원 확인). 서브 계정 키는 2.0 엔드포인트가 HTTP 403으로 거부하며, 이때 서버는 호출자 정보와 함께 안내문을 돌려주고 조회·외부 인증서 등록은 어떤 키로든 되는 1.0 도구(ncloud_list_certificates,ncloud_register_external_certificate)를 안내합니다.- Secret Manager (
ncloud_secret_*, 민간존)은 시크릿을 암호화한 KMS 키 종류에 따라 호스트가 다릅니다. 모든 도구의keyIsolation파라미터로 고릅니다 —global(기본,secretmanager.apigw.ntruss.com) /regional(KMS 리전 격리 키,ocapi-kr.ncloud.com/secretmanager; 일본 리전은 격리 키만). 격리 키 호스트는 서버 시작 시 리전(NCLOUD_REGION)으로 정해집니다.- Cloud DB Serverless (
ncloud_serverless_*, 민간존)도 메인 계정 Access Key로만 호출됩니다. 서브 계정 키는 API가 HTTP 403sub account is not supported yet로 거부하며(2026-10-02 재확인, NCP_ADMINISTRATOR 서브 계정), 서버는 그 403에 메인 계정 키를 쓰라는 안내를 덧붙입니다. 같은 키로 Cloud DB for MySQL 등 다른 DB 도구는 정상 동작합니다.- 현재 키가 메인 계정인지 서브 계정인지는
ncloud_get_caller_identity(STS, 세 존)로 확인할 수 있습니다.
공공존 설정 예시
금융존은 "NCLOUD_ZONE": "fin", "NCLOUD_REGION": "FKR"(생략 가능 — 금융존 기본값)에 금융존 콘솔에서 발급한 키를 넣으면 됩니다. 여러 존을 동시에 쓰려면 위처럼 이름이 다른 서버 항목을 여러 개(ncloud, ncloud-gov, ncloud-fin) 등록하면 됩니다.
존별 차이 (공식 가이드 대조, 2026-09-30 기준)
해당 존에서 제공되지 않는 도구는 등록 자체가 되지 않으므로 도구 목록에 나타나지 않습니다. ncloud_get_current_region으로 현재 서버가 묶인 존과 사용 가능한 리전을 확인할 수 있습니다.
MCP 클라이언트 설정
npx 사용 (권장)
mcp.json (또는 해당 클라이언트의 MCP 설정 파일)에 추가:
소스 빌드 사용
도구 그룹 선택 (선택)
기본 설정만으로 전체 도구(약 1,000개)가 모두 동작합니다. 그냥 다 쓰고 싶다면 이 변수를 설정하지 마세요 — 미설정이 곧 "전체 ON"이며 기존과 동일하게 동작합니다. 아래는 시작 컨텍스트를 가볍게 하거나(권장:
dynamic), 도구를 일부만 켜고 싶을 때만 보면 됩니다.
왜 필요한가요? 전체 ON이면 도구 정의만으로 세션 컨텍스트를 크게 점유합니다(tools/list ≈ 694KB / 약 177k 토큰). NCLOUD_TOOL_GROUPS로 필요한 그룹만 켜면 AI가 한 번에 보는 도구 수가 줄어 토큰 비용이 절감되고 도구 선택 정확도가 올라갑니다. 설정은 mcp.json의 env에 NCLOUD_TOOL_GROUPS 한 줄을 추가하면 됩니다. (common은 Region/Zone 공통 도구라 항상 자동 포함)
한눈에 — 어떤 값을 쓸까
핵심 규칙:
dynamic키워드가 있을 때만 세션 중 그룹 확장이 켜집니다.dynamic없이 그룹을 나열하면(예:compute,network) "딱 이것만"을 의미하는 잠금이 되고,all/미설정은 이미 전부 켜져 있어 확장이 무의미합니다(더 켤 그룹 없음). 사용 가능한 전체 그룹 key 목록은 아래 세부 제어의 표를 참조하세요.
권장: dynamic (동적 그룹)
전체를 다 켜는 대신 핵심 그룹만 켠 채 가볍게 시작하고, AI가 다른 서비스를 요청받으면 서버 재시작 없이 세션 중에 해당 그룹을 자동으로 켭니다.
한 줄 요약:
dynamic= "확장 모드 ON + 핵심 세트로 가볍게 시작". 안 쓰는 그룹은 처음에 안 올려 토큰을 아끼고, 필요할 때만 자동으로 켭니다.
- 시작 ON:
common+compute+network+database(약 367개 도구 / 약 65k 토큰 — 전체 대비 63% 절감) - AI는 항상 켜져 있는 메타 도구로 나머지 그룹에 도달합니다:
ncloud_list_tool_groups— 14개 그룹의 서비스·도구 수·현재 ON/OFF 조회ncloud_enable_tool_group— 그룹을 런타임에 활성화 (멱등)
dynamic vs all — 무엇이 다른가
둘 다 결국 모든 그룹을 쓸 수 있지만, dynamic은 "처음엔 핵심만, 나머지는 쓸 때" 방식이라 시작 컨텍스트가 가볍습니다. 이 절감이 dynamic의 존재 이유입니다.
동작 흐름 (예: Live Station 요청)
- 켜진 상태는 세션 동안만 유지됩니다(다음 세션은 기본값으로 리셋).
dynamic에 그룹 키를 더하면 그 그룹은 "시작 즉시 ON"입니다(나중에 동적으로 붙는 게 아님). 예:dynamic,analytics는 핵심 세트 + analytics를 처음부터 켜고 나머지만 확장 대상으로 둡니다. 매일 쓰는 그룹은 이렇게 적어두면 enable 호출 없이 바로 씁니다.
클라이언트 호환성 — 동적 추가된 도구가 즉시 나타나려면 클라이언트가 tools/list_changed 통지를 지원해야 합니다.
💡 표에 없거나 "미검증"인 클라이언트는 30초만에 직접 확인할 수 있습니다.
NCLOUD_TOOL_GROUPS=dynamic으로 설정 후 AI에게 *"media 그룹 켜고 Live Station 채널 목록 보여줘"*라고 요청 → 새 도구가 그 세션에서 호출되면 지원, AI가 도구를 못 찾으면 미지원이니 그룹을 미리 나열하는 방식으로 쓰면 됩니다.
list_changed 미지원 클라이언트(예: Kiro)에서는
dynamic의 세션 중 자동 확장이 동작하지 않습니다. enable은 되지만 새 도구가 도구 목록에 안 떠 호출할 수 없습니다. 이 경우 자주 쓰는 그룹을 미리 나열하세요 — 예:dynamic,governance,media처럼 시작부터 켜거나, 명시 리스트(compute,network,...)·all로 설정. (enable 응답도 같은 폴백을 안내합니다:NCLOUD_TOOL_GROUPS에 그룹을 추가하고 재시작.) 폴백 시 기존과 동일한 경험으로 회귀하므로 악화는 없습니다.
ℹ️ 권한 경계: MCP 도구가 노출된다고 권한이 부여되는 것은 아닙니다. Ncloud 측 실제 권한은 Access Key의 Sub Account 권한이 최종 경계입니다. 동적 로딩은 confirm 게이트·destructive 경고 등 기존 안전장치를 우회하지 않습니다.
세부 제어 — 특정 그룹만 켜기 / 잠금
dynamic 없이 그룹 key를 쉼표로 나열하면 그 그룹만 켜지고 런타임 확장이 잠깁니다(엄격 운영·최소 권한 환경용). 예: "NCLOUD_TOOL_GROUPS": "compute,network,billing". all,-billing처럼 -로 특정 그룹을 제외할 수도 있으며, 제외된 그룹은 동적 enable도 거부됩니다(운영자 보안 경계).
서버 시작 시 어떤 그룹이 로딩됐는지 로그로 확인할 수 있습니다:
ncloud-mcp-server: 4개 그룹 등록 (common, compute, network, billing)잘못된 key는 무시되고 경고만 출력됩니다.
그룹 key → 포함 서비스
사용 예시
MCP 클라이언트에서 자연어로 Ncloud 인프라를 관리할 수 있습니다:
지원 리전
민간존 (NCLOUD_ZONE=pub, 기본값)
참고: 미국 서부(
USWN), 독일(DEN) 리전은 Classic 환경만 지원되어 VPC 기반인 본 MCP 서버에서는 사용이 제한됩니다.
공공존 (NCLOUD_ZONE=gov)
참고: 공공존 Ncloud Storage·Archive Storage는
KR단일 리전이며, Object Storage는KR(gov-standard)·KRS(gov2-standard) 두 리전을 제공합니다.ncloud_set_region은 존의 리전 목록만 허용합니다.
금융존 (NCLOUD_ZONE=fin)
참고: 금융존은
FKR단일 리전이며NCLOUD_REGION미설정 시FKR이 기본값입니다. Object Storage는kr.object.fin-ncloudstorage.com(서명 리전fin-standard)을 씁니다.
문제 해결
프로젝트 구조
개발
기여
이슈와 PR을 환영합니다. 기여 시 다음을 참고해주세요:
- Fork 후 feature 브랜치에서 작업
npm run build로 빌드 확인npm test로 테스트 통과 확인- PR 제출
라이선스
來源:README.md,提交 5fe567e
工具
0版本歷史
6- v2.2.0最新Nov 11, 2026
- v2.1.0Oct 30, 2026
- v2.0.1Oct 2, 2026
- v1.16.0Sep 21, 2026
- v1.15.0Sep 16, 2026
- v1.14.0Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分