ncloud-mcp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 sjk4425
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# Ncloud MCP Server
+
+[English](./README_EN.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+
+Naver Cloud Platform(Ncloud) 인프라를 AI 어시스턴트에서 직접 관리할 수 있는 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 서버입니다.
+
+## 주요 기능
+
+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 호환), 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 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 |
+
+## 참고 사항
+
+- 이 MCP 서버는 **Ncloud 민간존(Public)** 기준으로 구현되었습니다. 금융존/공공존 환경에서는 API 엔드포인트가 다를 수 있습니다.
+- API 스펙은 [Ncloud API 공식 문서](https://api.ncloud-docs.com/docs/home)를 기반으로 작성되었습니다.
+- 한국(KR) 리전 위주로 테스트되었습니다. 다른 리전에서는 일부 API의 동작이 다를 수 있습니다.
+
+## 사전 요구사항
+
+- Node.js 20 이상
+- Ncloud API 인증키 ([포털에서 발급](https://www.ncloud.com/mypage/manage/authkey))
+
+## 설치
+
+```bash
+# 저장소 클론
+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 | - |
+
+## MCP 클라이언트 설정
+
+### Kiro / Claude Desktop / Cursor
+
+`mcp.json` (또는 해당 클라이언트의 MCP 설정 파일)에 추가:
+
+```json
+{
+  "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` |
+
+## 프로젝트 구조
+
+```
+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
+```
+
+## 개발
+
+```bash
+# 빌드
+npm run build
+
+# 테스트
+npm test
+
+# 타입 체크
+npx tsc --noEmit
+```
+
+## 기여
+
+이슈와 PR을 환영합니다. 기여 시 다음을 참고해주세요:
+
+1. Fork 후 feature 브랜치에서 작업
+2. `npm run build`로 빌드 확인
+3. `npm test`로 테스트 통과 확인
+4. PR 제출
+
+## 라이선스
+
+[MIT](./LICENSE)

package/README_EN.md

@@ -0,0 +1,159 @@
+# Ncloud MCP Server
+
+[한국어](./README.md)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for managing Naver Cloud Platform (Ncloud) infrastructure directly from AI assistants.
+
+## Features
+
+Provides **1,000+ API tools** across **60+ Ncloud services** via MCP protocol.
+
+| Category | Services |
+|----------|----------|
+| **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-compatible), NAS, Archive Storage (Swift-compatible) |
+| **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 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 |
+
+## Notes
+
+- This MCP server is built for the **Ncloud Public (민간존)** environment. API endpoints may differ for Financial or Government zones.
+- API specifications are based on the [Ncloud Official API Documentation](https://api.ncloud-docs.com/docs/home).
+- Primarily tested in the Korea (KR) region. Some APIs may behave differently in other regions.
+
+## Prerequisites
+
+- Node.js 20+
+- Ncloud API credentials ([Get from portal](https://www.ncloud.com/mypage/manage/authkey))
+
+## Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/sjk4425/ncloud-mcp-server.git
+cd ncloud-mcp-server
+
+# Install dependencies and build
+npm install
+npm run build
+```
+
+## Environment Variables
+
+| Variable | Required | Description | Default |
+|----------|----------|-------------|---------|
+| `NCLOUD_ACCESS_KEY` | ✅ | Ncloud API Access Key | - |
+| `NCLOUD_SECRET_KEY` | ✅ | Ncloud API Secret Key | - |
+| `NCLOUD_REGION` | - | Region code | `KR` |
+| `NCLOUD_API_URL` | - | API base URL | `https://ncloud.apigw.ntruss.com` |
+| `NCLOUD_ARCHIVE_PROJECT_ID` | - | Archive Storage project ID | - |
+| `NCLOUD_ARCHIVE_DOMAIN_ID` | - | Archive Storage domain ID | - |
+
+## MCP Client Configuration
+
+### Kiro / Claude Desktop / Cursor
+
+Add to your `mcp.json` (or equivalent MCP config file):
+
+```json
+{
+  "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"
+      }
+    }
+  }
+}
+```
+
+## Usage Examples
+
+Manage Ncloud infrastructure using natural language through your MCP client:
+
+```
+"List all my servers"
+"Create an Ubuntu server in KR-2 zone"
+"Show subnets in my-vpc"
+"Check Cloud DB for MySQL instance status"
+"Create a new bucket in Object Storage"
+"Show target groups attached to the load balancer"
+"Query top CPU usage servers from Cloud Insight"
+```
+
+## Supported Regions
+
+| Region | Code |
+|--------|------|
+| Korea | `KR` |
+| Japan | `JPN` |
+| Singapore | `SGN` |
+| US West | `USWN` |
+| Germany | `DEN` |
+
+## Project Structure
+
+```
+ncloud-mcp-server/
+├── src/
+│   ├── index.ts              # MCP server entry point (stdio transport)
+│   ├── auth/
+│   │   └── signature.ts      # HMAC-SHA256 signature generation
+│   ├── client/
+│   │   ├── ncloud-client.ts  # Ncloud API HTTP client
+│   │   ├── s3-compatible-client.ts   # Object Storage (S3-compatible)
+│   │   └── swift-compatible-client.ts # Archive Storage (Swift-compatible)
+│   └── tools/                # Service-specific MCP tools (63 files)
+│       ├── compute-server.ts
+│       ├── vpc.ts
+│       ├── cloud-insight.ts
+│       └── ...
+├── package.json
+├── tsconfig.json
+├── LICENSE
+└── README.md
+```
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Test
+npm test
+
+# Type check
+npx tsc --noEmit
+```
+
+## Contributing
+
+Issues and PRs are welcome. When contributing:
+
+1. Fork and work on a feature branch
+2. Verify build with `npm run build`
+3. Ensure tests pass with `npm test`
+4. Submit a PR
+
+## License
+
+[MIT](./LICENSE)

package/dist/auth/signature.d.ts

@@ -0,0 +1,16 @@
+export interface SignatureInput {
+    method: string;
+    url: string;
+    timestamp: string;
+    accessKey: string;
+    secretKey: string;
+}
+/**
+ * Creates the signing message in the format:
+ * "{METHOD} {URL}\n{TIMESTAMP}\n{ACCESS_KEY}"
+ */
+export declare function makeSignatureMessage(input: Omit<SignatureInput, "secretKey">): string;
+/**
+ * Generates HMAC-SHA256 signature encoded in Base64.
+ */
+export declare function generateSignature(input: SignatureInput): string;

package/dist/auth/signature.js

@@ -0,0 +1,18 @@
+import crypto from "node:crypto";
+/**
+ * Creates the signing message in the format:
+ * "{METHOD} {URL}\n{TIMESTAMP}\n{ACCESS_KEY}"
+ */
+export function makeSignatureMessage(input) {
+    return `${input.method} ${input.url}\n${input.timestamp}\n${input.accessKey}`;
+}
+/**
+ * Generates HMAC-SHA256 signature encoded in Base64.
+ */
+export function generateSignature(input) {
+    const message = makeSignatureMessage(input);
+    const hmac = crypto.createHmac("sha256", input.secretKey);
+    hmac.update(message);
+    return hmac.digest("base64");
+}
+//# sourceMappingURL=signature.js.map

package/dist/auth/signature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.js","sourceRoot":"","sources":["../../src/auth/signature.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAUjC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAwC;IAExC,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;AAChF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAqB;IACrD,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC"}

package/dist/auth/signature.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/auth/signature.test.js

@@ -0,0 +1,90 @@
+import { describe, test, expect } from "vitest";
+import fc from "fast-check";
+import crypto from "node:crypto";
+import { makeSignatureMessage, generateSignature } from "./signature.js";
+describe("Feature: ncloud-mcp-server, Property 1: 서명 메시지 포맷 일관성", () => {
+    test("makeSignatureMessage produces correct format for any valid inputs", () => {
+        const methodArb = fc.constantFrom("GET", "POST");
+        const pathArb = fc.stringMatching(/^\/[a-z0-9/]+$/);
+        const queryArb = fc.stringMatching(/^[a-zA-Z0-9=&_]+$/).map((q) => `?${q}`);
+        const urlArb = fc.tuple(pathArb, fc.oneof(fc.constant(""), queryArb)).map(([p, q]) => p + q);
+        const timestampArb = fc
+            .integer({ min: 1000000000000, max: 9999999999999 })
+            .map(String);
+        const accessKeyArb = fc.stringMatching(/^[A-Za-z0-9]{10,30}$/);
+        fc.assert(fc.property(methodArb, urlArb, timestampArb, accessKeyArb, (method, url, timestamp, accessKey) => {
+            const message = makeSignatureMessage({ method, url, timestamp, accessKey });
+            const lines = message.split("\n");
+            // Must have exactly 3 lines
+            expect(lines).toHaveLength(3);
+            // First line: "{METHOD} {URL}"
+            expect(lines[0]).toBe(`${method} ${url}`);
+            // Second line: timestamp
+            expect(lines[1]).toBe(timestamp);
+            // Third line: access key
+            expect(lines[2]).toBe(accessKey);
+            // URL with query string must be included in the message
+            if (url.includes("?")) {
+                expect(message).toContain(url);
+            }
+        }), { numRuns: 100 });
+    });
+});
+describe("Feature: ncloud-mcp-server, Property 2: 서명 생성 멱등성 및 유효성", () => {
+    test("generateSignature is idempotent and produces valid Base64", () => {
+        const methodArb = fc.constantFrom("GET", "POST");
+        const urlArb = fc.stringMatching(/^\/[a-z0-9/]+(\?[a-zA-Z0-9=&_]+)?$/);
+        const timestampArb = fc
+            .integer({ min: 1000000000000, max: 9999999999999 })
+            .map(String);
+        const keyArb = fc.stringMatching(/^[A-Za-z0-9]{10,40}$/);
+        fc.assert(fc.property(methodArb, urlArb, timestampArb, keyArb, keyArb, (method, url, timestamp, accessKey, secretKey) => {
+            const input = { method, url, timestamp, accessKey, secretKey };
+            // Idempotency: same input → same output
+            const sig1 = generateSignature(input);
+            const sig2 = generateSignature(input);
+            expect(sig1).toBe(sig2);
+            // Valid Base64: must match Base64 pattern
+            expect(sig1).toMatch(/^[A-Za-z0-9+/]+=*$/);
+            // Non-empty
+            expect(sig1.length).toBeGreaterThan(0);
+        }), { numRuns: 100 });
+    });
+});
+describe("Unit: 서명 정확성 검증 (알려진 입력/출력 쌍)", () => {
+    const knownInput = {
+        method: "GET",
+        url: "/vserver/v2/getServerInstanceList?responseFormatType=json",
+        timestamp: "1234567890123",
+        accessKey: "TestAccessKey",
+        secretKey: "TestSecretKey",
+    };
+    test("makeSignatureMessage produces expected message format", () => {
+        const message = makeSignatureMessage(knownInput);
+        expect(message).toBe("GET /vserver/v2/getServerInstanceList?responseFormatType=json\n1234567890123\nTestAccessKey");
+    });
+    test("generateSignature produces expected HMAC-SHA256 Base64 value", () => {
+        const signature = generateSignature(knownInput);
+        // Pre-computed expected value
+        expect(signature).toBe("FPsYYX8fuMAgi+cue3eACOW0dNtIwu1LYWfg/megA2M=");
+    });
+    test("generateSignature matches manual crypto computation", () => {
+        const message = `${knownInput.method} ${knownInput.url}\n${knownInput.timestamp}\n${knownInput.accessKey}`;
+        const hmac = crypto.createHmac("sha256", knownInput.secretKey);
+        hmac.update(message);
+        const expected = hmac.digest("base64");
+        const actual = generateSignature(knownInput);
+        expect(actual).toBe(expected);
+    });
+    test("different secret keys produce different signatures", () => {
+        const sig1 = generateSignature(knownInput);
+        const sig2 = generateSignature({ ...knownInput, secretKey: "DifferentKey" });
+        expect(sig1).not.toBe(sig2);
+    });
+    test("POST method produces different signature than GET", () => {
+        const sigGet = generateSignature(knownInput);
+        const sigPost = generateSignature({ ...knownInput, method: "POST" });
+        expect(sigGet).not.toBe(sigPost);
+    });
+});
+//# sourceMappingURL=signature.test.js.map

package/dist/auth/signature.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signature.test.js","sourceRoot":"","sources":["../../src/auth/signature.test.ts"],"names":[],"mappings":"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"}

package/dist/client/ncloud-client.d.ts

@@ -0,0 +1,27 @@
+export interface NcloudClientConfig {
+    accessKey: string;
+    secretKey: string;
+    baseUrl: string;
+    regionCode?: string;
+}
+export interface NcloudApiParams {
+    [key: string]: string | number | boolean | string[] | undefined;
+}
+export declare class NcloudClient {
+    private readonly accessKey;
+    private readonly secretKey;
+    private readonly baseUrl;
+    private regionCode;
+    constructor(config: NcloudClientConfig);
+    setRegionCode(regionCode: string): void;
+    getRegionCode(): string;
+    serializeListParams(params: NcloudApiParams): Record<string, string>;
+    private buildAuthHeaders;
+    request(action: string, params?: NcloudApiParams): Promise<any>;
+    requestRaw(method: string, path: string, queryParams?: Record<string, string | number | boolean | undefined>, body?: unknown): Promise<any>;
+    postRequest(path: string, body: unknown): Promise<any>;
+    putRequest(path: string, body: unknown): Promise<any>;
+    deleteRequest(path: string, body?: unknown): Promise<any>;
+    private unwrapResponse;
+    private handleErrorResponse;
+}