NCP MCP Server
Naver Cloud Platform (NCP) Model Context Protocol (MCP) Server for Claude Desktop
📋 프로젝트 소개
Claude Desktop과 연동하여 NCP(Naver Cloud Platform)의 인프라를 대화형으로 관리할 수 있는 MCP 서버입니다. Claude AI와 자연어로 대화하면서 클라우드 리소스를 생성, 조회, 관리할 수 있습니다.
✨ 주요 기능
서버 관리
- 서버 인스턴스 생성/시작/중지/삭제
- 서버 목록 조회 및 상세 정보 확인
네트워크 관리
- VPC (Virtual Private Cloud) 생성/조회/삭제
- Subnet 생성/조회/삭제
- ACG (Access Control Group) 생성/조회/삭제
- 보안 규칙 추가
로드 밸런서
- Load Balancer 생성/조회/삭제
- 타겟 서버 등록 및 관리
데이터베이스
- Cloud DB 인스턴스 생성/조회/삭제
🛠 기술 스택
- Language: TypeScript
- Runtime: Node.js
- Framework: Model Context Protocol (MCP) SDK
- API: Naver Cloud Platform REST API
- Authentication: NCP API Key (HMAC-SHA256 Signature)
📦 설치 방법
1. 저장소 클론
git clone https://github.com/YOUR_USERNAME/ncp-mcp-server.git
cd ncp-mcp-server
2. 의존성 설치
npm install
3. 환경 변수 설정
.env 파일을 생성하고 NCP API 키를 설정합니다:
NCP_ACCESS_KEY=your_access_key_here
NCP_SECRET_KEY=your_secret_key_here
4. 빌드
npm run build
🚀 사용 방법
Claude Desktop 설정
Claude Desktop의 설정 파일에 MCP 서버를 추가합니다:
macOS/Linux: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"ncp-compute": {
"command": "node",
"args": ["/path/to/ncp-compute-mcp-server/dist/index.js"],
"env": {
"NCP_ACCESS_KEY": "your_access_key",
"NCP_SECRET_KEY": "your_secret_key"
}
}
}
}
Claude Desktop에서 사용
Claude Desktop을 재시작한 후, 다음과 같이 자연어로 명령할 수 있습니다:
- "NCP 서버 목록 보여줘"
- "web-server-1 이름으로 서버 생성해줘"
- "서버 시작해줘"
- "로드 밸런서 생성해줘"
📝 API 목록
Server APIs
list_servers- 서버 인스턴스 목록 조회get_server_detail- 서버 상세 정보 조회create_server- 서버 생성start_server- 서버 시작stop_server- 서버 중지delete_server- 서버 삭제
VPC APIs
list_vpcs- VPC 목록 조회create_vpc- VPC 생성delete_vpc- VPC 삭제
Subnet APIs
list_subnets- Subnet 목록 조회create_subnet- Subnet 생성delete_subnet- Subnet 삭제
ACG APIs
list_acgs- ACG 목록 조회create_acg- ACG 생성delete_acg- ACG 삭제add_acg_rule- 인바운드 규칙 추가
Load Balancer APIs
list_load_balancers- Load Balancer 목록 조회create_load_balancer- Load Balancer 생성delete_load_balancer- Load Balancer 삭제add_load_balancer_target- 타겟 서버 추가
Cloud DB APIs
list_cloud_dbs- Cloud DB 목록 조회create_cloud_db- Cloud DB 생성delete_cloud_db- Cloud DB 삭제
🔐 보안
- NCP API 인증은 HMAC-SHA256 서명 방식 사용
- API 키는 환경 변수로 관리
.env파일은.gitignore에 포함되어 버전 관리에서 제외
🐛 트러블슈팅
401 Unauthorized 오류
- API 키가 올바른지 확인
- 서명 생성 시 쿼리 파라미터가 포함되는지 확인
404 Not Found 오류
- API 엔드포인트 경로 확인
- NCP API 버전 확인
400 Bad Request 오류
- 필수 파라미터 누락 확인 (예: serverCreateCount)
- 파라미터 형식 확인
📚 참고 자료
🎯 향후 계획
- Object Storage API 추가
- Monitoring (Cloud Insight) API 추가
- Auto Scaling API 추가
- Block Storage 관리 기능
- 인프라 자동 구축 템플릿
- 에러 핸들링 개선