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)
• 파라미터 형식 확인

📚 참고 자료

• Model Context Protocol
• NCP API Documentation
• Claude Desktop

🎯 향후 계획

• [ ] Object Storage API 추가
• [ ] Monitoring (Cloud Insight) API 추가
• [ ] Auto Scaling API 추가
• [ ] Block Storage 관리 기능
• [ ] 인프라 자동 구축 템플릿
• [ ] 에러 핸들링 개선