Which integrations are available for this server?

Manage Ncloud Kubernetes Service (NKS) clusters, including node groups, scaling, and configurations. Manage Cloud DB for MongoDB instances, including creation, monitoring, and configuration. Manage Cloud DB for MySQL instances, including creation, monitoring, and configuration. Integrates with Naver Cloud Platform to manage over 60 services including compute, networking, database, storage, and more via the MCP protocol. Manage Cloud DB for PostgreSQL instances, including creation, monitoring, and configuration. Manage Cloud DB for Redis instances, including creation, monitoring, and configuration.

How do I use ncloud-mcp-server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ncloud-mcp-server list my servers" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ncloud-mcp-server

by sjk4425

Overview Schema Related Servers Score Discussions

TypeScript

Remote

Ncloud MCP Server

English

npm version License: MIT Node.js TypeScript

Naver Cloud Platform(Ncloud) 인프라를 AI 어시스턴트에서 직접 관리할 수 있는 Model Context Protocol (MCP) 서버입니다.

주요 기능

Ncloud의 60개 이상 서비스, 1,000개 이상 API 도구를 MCP 프로토콜로 제공합니다.

카테고리	서비스
Compute	Server, Block Storage, Snapshot, Public IP, Init Script, Login Key, Placement Group, Fabric Cluster
Networking	VPC, Subnet, ACG, Network ACL, NAT Gateway, Route Table, VPC Peering, Network Interface, Load Balancer, Target Group, Global DNS, Global Traffic Manager
Database	Cloud DB for MySQL, PostgreSQL, MSSQL, MongoDB, Redis
Storage	Object Storage (S3 호환), Ncloud Storage (S3 호환), NAS, Archive Storage (Swift 호환)
Containers	Ncloud Kubernetes Service (NKS), Container Registry
Monitoring	Cloud Insight (Dashboard, Event, Rule, Plugin, Schema, Data, Integration)
DevTools	SourceCommit, SourceBuild, SourceDeploy, SourcePipeline
Media	VOD Station, Live Station, Image Optimizer
Security	Certificate Manager, Private CA, KMS, Security Monitoring
Application	Cloud Functions, API Gateway, SENS (SMS/Push)
Analytics	Search Engine Service, Cloud Hadoop, Cloud Data Streaming Service, Data Stream, Data Catalog, Data Forest, Data Flow, Data Query
Management	Sub Account, Activity Tracer, Resource Manager, Log Analytics, Cloud Advisor, Billing
Content Delivery	Global Edge
Auto Scaling	Launch Configuration, Auto Scaling Group, Scaling Policy

사전 요구사항

Node.js 20 이상
Ncloud API 인증키 (포털에서 발급)

참고 사항

이 MCP 서버는 Ncloud 민간존(Public) 기준으로 구현되었습니다. 금융존/공공존 환경에서는 API 엔드포인트가 다를 수 있습니다.
API 스펙은 Ncloud API 공식 문서를 기반으로 작성되었습니다.
한국(KR) 리전 위주로 테스트되었습니다. 다른 리전에서는 일부 API의 동작이 다를 수 있습니다.

설치

npx (권장 — 설치 불필요)

별도 설치 없이 npx로 바로 실행할 수 있습니다:

npx -y ncloud-mcp-server

MCP 클라이언트 설정 방법은 아래 MCP 클라이언트 설정 섹션을 참고하세요.

소스에서 빌드

# 저장소 클론
git clone https://github.com/sjk4425/ncloud-mcp-server.git
cd ncloud-mcp-server

# 의존성 설치 및 빌드
npm install
npm run build

환경 변수

변수	필수	설명	기본값
`NCLOUD_ACCESS_KEY`	✅	Ncloud API Access Key	-
`NCLOUD_SECRET_KEY`	✅	Ncloud API Secret Key	-
`NCLOUD_REGION`	-	리전 코드	`KR`
`NCLOUD_API_URL`	-	API 기본 URL	`https://ncloud.apigw.ntruss.com`
`NCLOUD_ARCHIVE_PROJECT_ID`	-	Archive Storage 프로젝트 ID	-
`NCLOUD_ARCHIVE_DOMAIN_ID`	-	Archive Storage 도메인 ID	-
`NCLOUD_TOOL_GROUPS`	-	로딩할 도구 그룹 선택(아래 참조). 미설정 시 전체 ON	전체
`NCLOUD_RESPONSE_PRUNE`	-	`1`이면 응답에서 빈 값(`null`/`""`/`[]`/`{}`)을 전역 제거	`0`

도구 그룹 선택 (`NCLOUD_TOOL_GROUPS`)

서비스가 약 1,000개 도구로 구성되어 있어, 필요한 그룹만 로딩하면 컨텍스트 토큰과 도구 선택 정확도가 개선됩니다. common 그룹은 항상 등록됩니다.

# 미설정 → 전체 그룹 ON (기존 동작과 동일)
# 특정 그룹만(+ common):
NCLOUD_TOOL_GROUPS=compute,network,billing
# 전부 켜되 일부 제외(감산):
NCLOUD_TOOL_GROUPS=all,-billing

사용 가능한 그룹 key: compute, network, database, storage, containers, monitoring, devtools, analytics, media, global, security, integration, billing (그리고 항상 켜지는 common).

MCP 클라이언트 설정

npx 사용 (권장)

mcp.json (또는 해당 클라이언트의 MCP 설정 파일)에 추가:

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

소스 빌드 사용

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

사용 예시

MCP 클라이언트에서 자연어로 Ncloud 인프라를 관리할 수 있습니다:

"현재 서버 목록을 보여줘"
"KR-2 존에 Ubuntu 서버를 하나 만들어줘"
"my-vpc의 서브넷 목록을 조회해줘"
"Cloud DB for MySQL 인스턴스 상태를 확인해줘"
"Object Storage에 새 버킷을 만들어줘"
"로드밸런서에 연결된 타겟 그룹을 확인해줘"
"Cloud Insight에서 CPU 사용률 상위 서버를 조회해줘"

지원 리전

리전	코드
한국	`KR`
일본	`JPN`
싱가포르	`SGN`

참고: 미국 서부(USWN), 독일(DEN) 리전은 Classic 환경만 지원되어 VPC 기반인 본 MCP 서버에서는 사용이 제한됩니다.

문제 해결

증상	원인	해결 방법
서버 시작 시 즉시 종료	환경 변수 미설정	`NCLOUD_ACCESS_KEY`, `NCLOUD_SECRET_KEY` 환경 변수가 설정되어 있는지 확인
`인증 실패` (HTTP 401)	API 인증키 오류	포털에서 키 상태가 활성인지 확인. 키 값에 공백이나 줄바꿈이 포함되지 않았는지 확인
`접근 거부` (HTTP 403)	서비스 권한 부족	서비스 이용 신청 여부 확인. Sub Account 사용 시 해당 서비스에 대한 API 권한 부여 필요
`유효하지 않은 리전입니다`	잘못된 리전 코드	지원 리전(KR, JPN, SGN) 확인. `ncloud_set_region` 도구로 변경 가능
`서비스 일시 불가` (HTTP 503)	API 엔드포인트 연결 불가	네트워크 상태 확인. 방화벽/프록시 환경에서는 `ncloud.apigw.ntruss.com` 아웃바운드 허용 필요
`요청 시간 초과` (HTTP 504)	API 응답 지연	잠시 후 재시도. 지속 시 Ncloud 상태 페이지 확인
`요청 제한 초과` (HTTP 429)	API Rate Limit 도달	요청 간격을 두고 재시도

프로젝트 구조

ncloud-mcp-server/
├── src/
│   ├── index.ts              # MCP 서버 엔트리포인트 (stdio transport)
│   ├── auth/
│   │   └── signature.ts      # HMAC-SHA256 서명 생성
│   ├── client/
│   │   ├── ncloud-client.ts  # Ncloud API HTTP 클라이언트
│   │   ├── s3-compatible-client.ts   # Object Storage (S3 호환)
│   │   └── swift-compatible-client.ts # Archive Storage (Swift 호환)
│   └── tools/                # 서비스별 MCP 도구 (63개 파일)
│       ├── compute-server.ts
│       ├── vpc.ts
│       ├── cloud-insight.ts
│       └── ...
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md

개발

# 빌드
npm run build

# 테스트
npm test

# 타입 체크
npx tsc --noEmit

기여

이슈와 PR을 환영합니다. 기여 시 다음을 참고해주세요:

Fork 후 feature 브랜치에서 작업
npm run build로 빌드 확인
npm test로 테스트 통과 확인
PR 제출

라이선스

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

3dRelease cycle

4Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sjk4425/ncloud-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server