ncloud-mcp-server 1.0.4 → 1.1.0

package/README.md

@@ -18,14 +18,14 @@ 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 호환) |
+| **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 Catalog, Data Forest, Data Flow, Data Query |
+| **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 |
@@ -75,6 +75,22 @@ npm run build
 | `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 클라이언트 설정
 

package/README_EN.md

@@ -18,14 +18,14 @@ Provides **1,000+ API tools** across **60+ Ncloud services** via MCP protocol.
 | **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) |
+| **Storage** | Object Storage (S3-compatible), Ncloud 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 |
+| **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 |
@@ -75,6 +75,22 @@ npm run build
 | `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 | - |
+| `NCLOUD_TOOL_GROUPS` | - | Select which tool groups to load (see below). All groups ON when unset | all |
+| `NCLOUD_RESPONSE_PRUNE` | - | When `1`, globally strips empty values (`null`/`""`/`[]`/`{}`) from responses | `0` |
+
+### Tool Group Selection (`NCLOUD_TOOL_GROUPS`)
+
+The server exposes ~1,000 tools. Loading only the groups you need reduces context tokens and improves tool-selection accuracy. The `common` group is always registered.
+
+```
+# Unset → all groups ON (same as before)
+# Specific groups only (+ common):
+NCLOUD_TOOL_GROUPS=compute,network,billing
+# All groups, but exclude some (subtractive):
+NCLOUD_TOOL_GROUPS=all,-billing
+```
+
+Available group keys: `compute`, `network`, `database`, `storage`, `containers`, `monitoring`, `devtools`, `analytics`, `media`, `global`, `security`, `integration`, `billing` (plus the always-on `common`).
 
 ## MCP Client Configuration
 

package/dist/index.js

@@ -1,10 +1,7 @@
 #!/usr/bin/env node
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { NcloudClient } from "./client/ncloud-client.js";
-import { S3CompatibleClient } from "./client/s3-compatible-client.js";
-import { SwiftCompatibleClient } from "./client/swift-compatible-client.js";
-import { registerCommonTools, registerComputeServerTools, registerComputeStorageTools, registerComputePublicIpTools, registerComputeLoginKeyTools, registerComputeInitScriptTools, registerComputePlacementTools, registerVpcTools, registerAcgTools, registerNetworkAclTools, registerNatGatewayTools, registerRouteTableTools, registerVpcPeeringTools, registerNetworkInterfaceTools, registerLoadBalancerTools, registerTargetGroupTools, registerAutoScalingTools, registerDatabaseMysqlTools, registerDatabasePostgresqlTools, registerDatabaseMssqlTools, registerDatabaseMongodbTools, registerDatabaseCacheTools, registerStorageObjectTools, registerStorageNcloudTools, registerContainersNksTools, registerContainersRegistryTools, registerActivityTracerTools, registerStorageNasTools, registerLogAnalyticsTools, registerCertificateManagerTools, registerSecurityMonitoringTools, registerCloudInsightTools, registerCloudInsightRuleTools, registerCloudInsightPluginTools, registerCloudInsightIntegrationTools, registerSourceCommitTools, registerSourceBuildTools, registerSourceDeployTools, registerSourcePipelineTools, registerGlobalEdgeTools, registerVodStationTools, registerLiveStationTools, registerImageOptimizerTools, registerSubAccountTools, registerApiGatewayTools, registerSensTools, registerSearchEngineServiceTools, registerCloudHadoopTools, registerCloudDataStreamingTools, registerDataStreamTools, registerCloudFunctionsTools, registerResourceManagerTools, registerGlobalDnsTools, registerGlobalTrafficManagerTools, registerStorageArchiveTools, registerDataCatalogTools, registerDataForestTools, registerCloudAdvisorTools, registerDataFlowTools, registerDataQueryTools, registerPrivateCaTools, registerKmsTools, registerBillingTools } from "./tools/index.js";
+import { makeClientFactory, resolveGroups, registerGroups, } from "./tools/registry.js";
 // Validate required environment variables
 const accessKey = process.env.NCLOUD_ACCESS_KEY;
 const secretKey = process.env.NCLOUD_SECRET_KEY;
@@ -17,339 +14,23 @@ if (!secretKey) {
     process.exit(1);
 }
 const regionCode = process.env.NCLOUD_REGION ?? "KR";
-const baseUrl = process.env.NCLOUD_API_URL ?? "https://ncloud.apigw.ntruss.com";
-// Create NcloudClient for general APIs
-const client = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl,
-    regionCode,
-});
-// Create NcloudClient for Cloud Insight APIs
-const cloudInsightClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://cw.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for Container Registry APIs
-const ncrClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://ncr.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for Cloud Activity Tracer APIs
-const activityTracerClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://cloudactivitytracer.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for SourceCommit APIs
-const sourceCommitClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://sourcecommit.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for SourceBuild APIs
-const sourceBuildClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://sourcebuild.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for SourceDeploy APIs (VPC)
-const sourceDeployClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://vpcsourcedeploy.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for SourcePipeline APIs (VPC)
-const sourcePipelineClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://vpcsourcepipeline.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for Global Edge APIs
-const globalEdgeClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://edge.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for VOD Station APIs
-const vodStationClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://vodstation.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for Live Station APIs
-const liveStationClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://livestation.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for Image Optimizer APIs
-const imageOptimizerClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://imageoptimizer.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for Sub Account (IAM) APIs
-const subAccountClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://subaccount.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for Certificate Manager APIs (v2)
-const certificateManagerClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://certificatemanager.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for API Gateway APIs
-const apiGatewayClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://apigateway.apigw.ntruss.com",
-    regionCode,
-});
-// Create NcloudClient for SENS APIs
-const sensClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://sens.apigw.ntruss.com",
-    regionCode,
-});
-// Create S3CompatibleClient for Object Storage APIs
-const s3Client = new S3CompatibleClient({
-    accessKey,
-    secretKey,
-    regionCode,
-    storageType: "object",
-});
-// Create S3CompatibleClient for Ncloud Storage APIs
-const ncloudStorageClient = new S3CompatibleClient({
-    accessKey,
-    secretKey,
-    regionCode,
-    storageType: "ncloud",
-});
+const creds = { accessKey, secretKey };
 // Create MCP Server
 const server = new McpServer({
     name: "ncloud-mcp-server",
-    version: "1.0.0",
-});
-// Register all tools
-registerCommonTools(server, client);
-registerComputeServerTools(server, client);
-registerComputeStorageTools(server, client);
-registerComputePublicIpTools(server, client);
-registerComputeLoginKeyTools(server, client);
-registerComputeInitScriptTools(server, client);
-registerComputePlacementTools(server, client);
-registerVpcTools(server, client);
-registerAcgTools(server, client);
-registerNetworkAclTools(server, client);
-registerNatGatewayTools(server, client);
-registerRouteTableTools(server, client);
-registerVpcPeeringTools(server, client);
-registerNetworkInterfaceTools(server, client);
-registerLoadBalancerTools(server, client);
-registerTargetGroupTools(server, client);
-registerAutoScalingTools(server, client);
-registerDatabaseMysqlTools(server, client);
-registerDatabasePostgresqlTools(server, client);
-registerDatabaseMssqlTools(server, client);
-registerDatabaseMongodbTools(server, client);
-registerDatabaseCacheTools(server, client);
-registerStorageObjectTools(server, s3Client);
-registerStorageNcloudTools(server, ncloudStorageClient);
-// Create NcloudClient for NKS (Ncloud Kubernetes Service) APIs
-const nksClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://nks.apigw.ntruss.com",
-    regionCode,
-});
-registerContainersNksTools(server, nksClient);
-registerContainersRegistryTools(server, ncrClient);
-registerActivityTracerTools(server, activityTracerClient);
-registerStorageNasTools(server, client);
-registerLogAnalyticsTools(server, client);
-registerCertificateManagerTools(server, certificateManagerClient);
-registerSecurityMonitoringTools(server, client);
-registerCloudInsightTools(server, cloudInsightClient);
-registerCloudInsightRuleTools(server, cloudInsightClient);
-registerCloudInsightPluginTools(server, cloudInsightClient);
-registerCloudInsightIntegrationTools(server, cloudInsightClient);
-registerSourceCommitTools(server, sourceCommitClient);
-registerSourceBuildTools(server, sourceBuildClient);
-registerSourceDeployTools(server, sourceDeployClient);
-registerSourcePipelineTools(server, sourcePipelineClient);
-registerGlobalEdgeTools(server, globalEdgeClient);
-registerVodStationTools(server, vodStationClient);
-registerLiveStationTools(server, liveStationClient);
-registerImageOptimizerTools(server, imageOptimizerClient);
-registerSubAccountTools(server, subAccountClient);
-registerApiGatewayTools(server, apiGatewayClient);
-registerSensTools(server, sensClient);
-// Create NcloudClient for Search Engine Service APIs
-const sesClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://vpcsearchengine.apigw.ntruss.com",
-    regionCode,
-});
-registerSearchEngineServiceTools(server, sesClient);
-registerCloudHadoopTools(server, client);
-// Create NcloudClient for Cloud Data Streaming Service (CDSS) APIs
-const cdssClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://clouddatastreamingservice.apigw.ntruss.com",
-    regionCode,
-});
-registerCloudDataStreamingTools(server, cdssClient);
-// Create NcloudClient for Data Stream APIs (Topic, Connector, Schema)
-const dataStreamClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://datastream.apigw.ntruss.com",
-    regionCode,
+    version: "1.1.0",
 });
-// Create NcloudClient for Data Stream Message API (different base URL)
-const dataStreamMessageClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://api.datastream.naverncp.com",
+// 그룹 단위 도구 등록 (NCLOUD_TOOL_GROUPS 미설정 시 전체 ON = 기존 동작 동일)
+const ctx = {
+    server,
+    client: makeClientFactory(creds, regionCode),
     regionCode,
-});
-registerDataStreamTools(server, dataStreamClient, dataStreamMessageClient);
-// Create NcloudClient for Cloud Functions APIs (region-specific base URL)
-const cloudFunctionsBaseUrlMap = {
-    KR: "https://cloudfunctions.apigw.ntruss.com",
-    SGN: "https://sg-cloudfunctions.apigw.ntruss.com",
-    JPN: "https://jp-cloudfunctions.apigw.ntruss.com",
+    creds,
+    env: process.env,
 };
-const cloudFunctionsBaseUrl = cloudFunctionsBaseUrlMap[regionCode] ?? "https://cloudfunctions.apigw.ntruss.com";
-const cloudFunctionsClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: cloudFunctionsBaseUrl,
-    regionCode,
-});
-registerCloudFunctionsTools(server, cloudFunctionsClient);
-// Create NcloudClient for Resource Manager APIs
-const resourceManagerClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://resourcemanager.apigw.ntruss.com",
-    regionCode,
-});
-registerResourceManagerTools(server, resourceManagerClient);
-// Create NcloudClient for Global DNS APIs
-const globalDnsClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://globaldns.apigw.ntruss.com",
-    regionCode,
-});
-registerGlobalDnsTools(server, globalDnsClient);
-// Create NcloudClient for Global Traffic Manager APIs
-const gtmClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://globaltrafficmanager.apigw.ntruss.com",
-    regionCode,
-});
-registerGlobalTrafficManagerTools(server, gtmClient);
-// Create NcloudClient for Data Catalog APIs
-const dataCatalogClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://datacatalog.apigw.ntruss.com",
-    regionCode,
-});
-registerDataCatalogTools(server, dataCatalogClient);
-// Create NcloudClient for Data Forest APIs
-const dataForestClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://df.apigw.ntruss.com",
-    regionCode,
-});
-registerDataForestTools(server, dataForestClient);
-// Create NcloudClient for Cloud Advisor APIs
-const cloudAdvisorClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://cloud-advisor.apigw.ntruss.com",
-    regionCode,
-});
-registerCloudAdvisorTools(server, cloudAdvisorClient);
-// Create NcloudClient for Data Flow APIs
-const dataFlowClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://dataflow.apigw.ntruss.com",
-    regionCode,
-});
-registerDataFlowTools(server, dataFlowClient);
-// Create NcloudClient for Data Query APIs
-const dataQueryClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://kr.dataquery.naverncp.com",
-    regionCode,
-});
-registerDataQueryTools(server, dataQueryClient);
-// Create NcloudClient for Private CA APIs
-const privateCaClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://pca.apigw.ntruss.com",
-    regionCode,
-});
-registerPrivateCaTools(server, privateCaClient);
-// Create NcloudClient for KMS API 2.0
-const kmsClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://ocapi.ncloud.com",
-    regionCode,
-});
-registerKmsTools(server, kmsClient);
-// Create NcloudClient for Billing APIs (List Price, Cost and Usage, Discount)
-const billingClient = new NcloudClient({
-    accessKey,
-    secretKey,
-    baseUrl: "https://billingapi.apigw.ntruss.com",
-    regionCode,
-});
-registerBillingTools(server, billingClient);
-// Create SwiftCompatibleClient for Archive Storage APIs (optional — requires NCLOUD_ARCHIVE_PROJECT_ID and NCLOUD_ARCHIVE_DOMAIN_ID)
-const archiveProjectId = process.env.NCLOUD_ARCHIVE_PROJECT_ID;
-const archiveDomainId = process.env.NCLOUD_ARCHIVE_DOMAIN_ID;
-if (archiveProjectId && archiveDomainId) {
-    const swiftClient = new SwiftCompatibleClient({
-        accessKey,
-        secretKey,
-        projectId: archiveProjectId,
-        domainId: archiveDomainId,
-        regionCode,
-    });
-    registerStorageArchiveTools(server, swiftClient);
-}
+const groups = resolveGroups(process.env.NCLOUD_TOOL_GROUPS);
+registerGroups(ctx, groups);
+console.error(`ncloud-mcp-server: ${groups.length}개 그룹 등록 (${groups.map((g) => g.key).join(", ")})`);
 // Connect via stdio transport
 async function main() {
     const transport = new StdioServerTransport();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,+BAA+B,EAAE,oCAAoC,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,gCAAgC,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,iCAAiC,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE9tD,0CAA0C;AAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAChD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAEhD,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC;AACrD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,iCAAiC,CAAC;AAEhF,uCAAuC;AACvC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;IAC9B,SAAS;IACT,SAAS;IACT,OAAO;IACP,UAAU;CACX,CAAC,CAAC;AAEH,6CAA6C;AAC7C,MAAM,kBAAkB,GAAG,IAAI,YAAY,CAAC;IAC1C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,6BAA6B;IACtC,UAAU;CACX,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;IACjC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,8BAA8B;IACvC,UAAU;CACX,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,oBAAoB,GAAG,IAAI,YAAY,CAAC;IAC5C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,8CAA8C;IACvD,UAAU;CACX,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,kBAAkB,GAAG,IAAI,YAAY,CAAC;IAC1C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,uCAAuC;IAChD,UAAU;CACX,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,iBAAiB,GAAG,IAAI,YAAY,CAAC;IACzC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,sCAAsC;IAC/C,UAAU;CACX,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,kBAAkB,GAAG,IAAI,YAAY,CAAC;IAC1C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,0CAA0C;IACnD,UAAU;CACX,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,oBAAoB,GAAG,IAAI,YAAY,CAAC;IAC5C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,4CAA4C;IACrD,UAAU;CACX,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC;IACxC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,+BAA+B;IACxC,UAAU;CACX,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC;IACxC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,qCAAqC;IAC9C,UAAU;CACX,CAAC,CAAC;AAEH,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG,IAAI,YAAY,CAAC;IACzC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,sCAAsC;IAC/C,UAAU;CACX,CAAC,CAAC;AAEH,+CAA+C;AAC/C,MAAM,oBAAoB,GAAG,IAAI,YAAY,CAAC;IAC5C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,yCAAyC;IAClD,UAAU;CACX,CAAC,CAAC;AAEH,iDAAiD;AACjD,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC;IACxC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,qCAAqC;IAC9C,UAAU;CACX,CAAC,CAAC;AAEH,wDAAwD;AACxD,MAAM,wBAAwB,GAAG,IAAI,YAAY,CAAC;IAChD,SAAS;IACT,SAAS;IACT,OAAO,EAAE,6CAA6C;IACtD,UAAU;CACX,CAAC,CAAC;AAEH,2CAA2C;AAC3C,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC;IACxC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,qCAAqC;IAC9C,UAAU;CACX,CAAC,CAAC;AAEH,oCAAoC;AACpC,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC;IAClC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,+BAA+B;IACxC,UAAU;CACX,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC;IACtC,SAAS;IACT,SAAS;IACT,UAAU;IACV,WAAW,EAAE,QAAQ;CACtB,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,mBAAmB,GAAG,IAAI,kBAAkB,CAAC;IACjD,SAAS;IACT,SAAS;IACT,UAAU;IACV,WAAW,EAAE,QAAQ;CACtB,CAAC,CAAC;AAEH,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,qBAAqB;AACrB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACpC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5C,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC/C,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9C,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjC,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACjC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,6BAA6B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC9C,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACzC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,+BAA+B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChD,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,4BAA4B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC3C,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7C,0BAA0B,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AACxD,+DAA+D;AAC/D,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;IACjC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,8BAA8B;IACvC,UAAU;CACX,CAAC,CAAC;AACH,0BAA0B,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC9C,+BAA+B,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACnD,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAC1D,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACxC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1C,+BAA+B,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;AAClE,+BAA+B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAChD,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACtD,6BAA6B,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAC1D,+BAA+B,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAC5D,oCAAoC,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACjE,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACtD,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AACpD,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACtD,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAC1D,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAClD,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAClD,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AACpD,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAC1D,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAClD,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAClD,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEtC,qDAAqD;AACrD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;IACjC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,0CAA0C;IACnD,UAAU;CACX,CAAC,CAAC;AACH,gCAAgC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AACpD,wBAAwB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzC,mEAAmE;AACnE,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC;IAClC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,oDAAoD;IAC7D,UAAU;CACX,CAAC,CAAC;AACH,+BAA+B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEpD,sEAAsE;AACtE,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC;IACxC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,qCAAqC;IAC9C,UAAU;CACX,CAAC,CAAC;AACH,uEAAuE;AACvE,MAAM,uBAAuB,GAAG,IAAI,YAAY,CAAC;IAC/C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,qCAAqC;IAC9C,UAAU;CACX,CAAC,CAAC;AACH,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,EAAE,uBAAuB,CAAC,CAAC;AAE3E,0EAA0E;AAC1E,MAAM,wBAAwB,GAA2B;IACvD,EAAE,EAAE,yCAAyC;IAC7C,GAAG,EAAE,4CAA4C;IACjD,GAAG,EAAE,4CAA4C;CAClD,CAAC;AACF,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,UAAU,CAAC,IAAI,yCAAyC,CAAC;AAChH,MAAM,oBAAoB,GAAG,IAAI,YAAY,CAAC;IAC5C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,qBAAqB;IAC9B,UAAU;CACX,CAAC,CAAC;AACH,2BAA2B,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAE1D,gDAAgD;AAChD,MAAM,qBAAqB,GAAG,IAAI,YAAY,CAAC;IAC7C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,0CAA0C;IACnD,UAAU;CACX,CAAC,CAAC;AACH,4BAA4B,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;AAE5D,0CAA0C;AAC1C,MAAM,eAAe,GAAG,IAAI,YAAY,CAAC;IACvC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,oCAAoC;IAC7C,UAAU;CACX,CAAC,CAAC;AACH,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEhD,sDAAsD;AACtD,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;IACjC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,+CAA+C;IACxD,UAAU;CACX,CAAC,CAAC;AACH,iCAAiC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAErD,4CAA4C;AAC5C,MAAM,iBAAiB,GAAG,IAAI,YAAY,CAAC;IACzC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,sCAAsC;IAC/C,UAAU;CACX,CAAC,CAAC;AACH,wBAAwB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC;IACxC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,6BAA6B;IACtC,UAAU;CACX,CAAC,CAAC;AACH,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAElD,6CAA6C;AAC7C,MAAM,kBAAkB,GAAG,IAAI,YAAY,CAAC;IAC1C,SAAS;IACT,SAAS;IACT,OAAO,EAAE,wCAAwC;IACjD,UAAU;CACX,CAAC,CAAC;AACH,yBAAyB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEtD,yCAAyC;AACzC,MAAM,cAAc,GAAG,IAAI,YAAY,CAAC;IACtC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,mCAAmC;IAC5C,UAAU;CACX,CAAC,CAAC;AACH,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE9C,0CAA0C;AAC1C,MAAM,eAAe,GAAG,IAAI,YAAY,CAAC;IACvC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,mCAAmC;IAC5C,UAAU;CACX,CAAC,CAAC;AACH,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEhD,0CAA0C;AAC1C,MAAM,eAAe,GAAG,IAAI,YAAY,CAAC;IACvC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,8BAA8B;IACvC,UAAU;CACX,CAAC,CAAC;AACH,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEhD,sCAAsC;AACtC,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC;IACjC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,0BAA0B;IACnC,UAAU;CACX,CAAC,CAAC;AACH,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEpC,8EAA8E;AAC9E,MAAM,aAAa,GAAG,IAAI,YAAY,CAAC;IACrC,SAAS;IACT,SAAS;IACT,OAAO,EAAE,qCAAqC;IAC9C,UAAU;CACX,CAAC,CAAC;AACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE5C,qIAAqI;AACrI,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;AAC/D,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;AAC7D,IAAI,gBAAgB,IAAI,eAAe,EAAE,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,qBAAqB,CAAC;QAC5C,SAAS;QACT,SAAS;QACT,SAAS,EAAE,gBAAgB;QAC3B,QAAQ,EAAE,eAAe;QACzB,UAAU;KACX,CAAC,CAAC;IACH,2BAA2B,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,8BAA8B;AAC9B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,GAEf,MAAM,qBAAqB,CAAC;AAE7B,0CAA0C;AAC1C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAChD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AAEhD,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC;AACrD,MAAM,KAAK,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAEvC,oBAAoB;AACpB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,GAAG,GAAgB;IACvB,MAAM;IACN,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAC;IAC5C,UAAU;IACV,KAAK;IACL,GAAG,EAAE,OAAO,CAAC,GAAG;CACjB,CAAC;AACF,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AAC7D,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC5B,OAAO,CAAC,KAAK,CACX,sBAAsB,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CACtF,CAAC;AAEF,8BAA8B;AAC9B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/_response.d.ts

@@ -0,0 +1,69 @@
+/**
+ * 공통 MCP 도구 응답 헬퍼.
+ *
+ * 모든 도구는 `{ content: [{ type: "text", text: ... }] }` 형태로 응답한다(CLAUDE.md 컨벤션).
+ * 기존에는 각 도구가 `JSON.stringify(result, null, 2)`를 직접 호출해 들여쓰기가 포함된
+ * 큰 응답을 만들었다. `toolText()`로 통일해 들여쓰기를 제거하고(토큰 30~40% 절감),
+ * 선택적으로 빈 값을 prune 한다.
+ *
+ * 설계: DESIGN_modularization-and-response.md §3
+ */
+/**
+ * 응답 객체에서 "정보 없음"에 해당하는 빈 값을 재귀적으로 제거한다.
+ * 제거 대상: `null`, `undefined`, 빈 문자열 `""`, 빈 배열 `[]`, 빈 객체 `{}`.
+ * 보존: 숫자 `0`, 불리언 `false` (의미 있는 값).
+ *
+ * ⚠️ 일부 NCP API는 의미 있는 `""`(빈 문자열)을 반환할 수 있으므로 기본 OFF(옵트인).
+ */
+export declare function prune(v: any): any;
+export interface ToolTextOptions {
+    /** 빈 값 제거. 미지정 시 `NCLOUD_RESPONSE_PRUNE === "1"` 전역 설정을 따른다. */
+    prune?: boolean;
+}
+/**
+ * 도구 결과를 표준 MCP 텍스트 응답으로 직렬화한다.
+ * 들여쓰기 없이(`JSON.stringify(data)`) 직렬화해 토큰을 절감한다.
+ */
+export declare function toolText(result: any, opts?: ToolTextOptions): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export interface PageMeta {
+    pageNo: number;
+    pageSize: number;
+    /** 이 페이지에서 실제 반환된 항목 수(가드로 줄었을 수 있음). */
+    returnedRows: number;
+    /** 페이징 대상 전체 대비 더 받을 항목이 남았는지. */
+    hasMore: boolean;
+    /** 다음 페이지 번호. 가드로 잘렸으면(=페이지 건너뛰기 손실 위험) null. */
+    nextPageNo: number | null;
+    /** 하드 크기 가드가 이 페이지에서 항목을 잘랐으면 true. */
+    truncated?: boolean;
+    /**
+     * 가드 발동 시, 이 값 이하의 `pageSize`로 재조회하면 (결정적 정렬 위에서) 전수를
+     * 누락 없이 순회할 수 있다는 회복 힌트. 가드 미발동 시 미포함.
+     */
+    suggestedPageSize?: number;
+}
+export interface PageResult {
+    items: any[];
+    meta: PageMeta;
+}
+/**
+ * 가공 완료된 항목 배열을 페이지로 자르고, 직렬화 크기 하드 가드를 적용한다.
+ *
+ * - 페이지네이션(`pageNo`/`pageSize`)이 주 메커니즘 — 안정 정렬된 배열을 결정적으로 슬라이스.
+ * - 하드 가드는 backstop — 슬라이스 직렬화 길이가 `maxBytes` 초과 시 **항목 단위로**
+ *   뒤에서부터 제거(글자 수 컷 금지 → JSON 깨짐/부분 항목 방지). 최소 1개는 남긴다.
+ * - 가드가 발동하면 페이지 건너뛰기로 항목이 조용히 사라지는 걸 막기 위해 `nextPageNo`를
+ *   주지 않는다(사용자는 `pageSize`를 줄이거나 쿼리를 좁혀 재조회).
+ *
+ * 호출자는 도메인 메타(`totalRows`/`matchedRows` 등)와 안내 문구를 결과에 합쳐 반환한다.
+ */
+export declare function paginateWithGuard(items: any[], opts: {
+    pageNo?: number;
+    pageSize: number;
+    maxBytes: number;
+}): PageResult;

package/dist/tools/_response.js

@@ -0,0 +1,96 @@
+/**
+ * 공통 MCP 도구 응답 헬퍼.
+ *
+ * 모든 도구는 `{ content: [{ type: "text", text: ... }] }` 형태로 응답한다(CLAUDE.md 컨벤션).
+ * 기존에는 각 도구가 `JSON.stringify(result, null, 2)`를 직접 호출해 들여쓰기가 포함된
+ * 큰 응답을 만들었다. `toolText()`로 통일해 들여쓰기를 제거하고(토큰 30~40% 절감),
+ * 선택적으로 빈 값을 prune 한다.
+ *
+ * 설계: DESIGN_modularization-and-response.md §3
+ */
+/**
+ * 응답 객체에서 "정보 없음"에 해당하는 빈 값을 재귀적으로 제거한다.
+ * 제거 대상: `null`, `undefined`, 빈 문자열 `""`, 빈 배열 `[]`, 빈 객체 `{}`.
+ * 보존: 숫자 `0`, 불리언 `false` (의미 있는 값).
+ *
+ * ⚠️ 일부 NCP API는 의미 있는 `""`(빈 문자열)을 반환할 수 있으므로 기본 OFF(옵트인).
+ */
+export function prune(v) {
+    if (Array.isArray(v)) {
+        const arr = v.map(prune).filter((x) => !isEmpty(x));
+        return arr;
+    }
+    if (v !== null && typeof v === "object") {
+        const out = {};
+        for (const [k, val] of Object.entries(v)) {
+            const pruned = prune(val);
+            if (!isEmpty(pruned))
+                out[k] = pruned;
+        }
+        return out;
+    }
+    return v;
+}
+function isEmpty(v) {
+    if (v === null || v === undefined)
+        return true;
+    if (v === "")
+        return true;
+    if (Array.isArray(v))
+        return v.length === 0;
+    if (typeof v === "object")
+        return Object.keys(v).length === 0;
+    return false;
+}
+/**
+ * 도구 결과를 표준 MCP 텍스트 응답으로 직렬화한다.
+ * 들여쓰기 없이(`JSON.stringify(data)`) 직렬화해 토큰을 절감한다.
+ */
+export function toolText(result, opts) {
+    const doPrune = opts?.prune ?? (process.env.NCLOUD_RESPONSE_PRUNE === "1");
+    const data = doPrune ? prune(result) : result;
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+/**
+ * 가공 완료된 항목 배열을 페이지로 자르고, 직렬화 크기 하드 가드를 적용한다.
+ *
+ * - 페이지네이션(`pageNo`/`pageSize`)이 주 메커니즘 — 안정 정렬된 배열을 결정적으로 슬라이스.
+ * - 하드 가드는 backstop — 슬라이스 직렬화 길이가 `maxBytes` 초과 시 **항목 단위로**
+ *   뒤에서부터 제거(글자 수 컷 금지 → JSON 깨짐/부분 항목 방지). 최소 1개는 남긴다.
+ * - 가드가 발동하면 페이지 건너뛰기로 항목이 조용히 사라지는 걸 막기 위해 `nextPageNo`를
+ *   주지 않는다(사용자는 `pageSize`를 줄이거나 쿼리를 좁혀 재조회).
+ *
+ * 호출자는 도메인 메타(`totalRows`/`matchedRows` 등)와 안내 문구를 결과에 합쳐 반환한다.
+ */
+export function paginateWithGuard(items, opts) {
+    const pageNo = Math.max(1, Math.floor(opts.pageNo ?? 1));
+    const pageSize = Math.max(1, Math.floor(opts.pageSize));
+    const start = (pageNo - 1) * pageSize;
+    let slice = items.slice(start, start + pageSize);
+    let truncated = false;
+    while (slice.length > 1 && JSON.stringify(slice).length > opts.maxBytes) {
+        slice = slice.slice(0, -1);
+        truncated = true;
+    }
+    // 단일 항목 자체가 임계 초과면 더 줄일 수 없음 — 그래도 truncated로 표기(요약 필요 신호).
+    if (slice.length >= 1 && JSON.stringify(slice).length > opts.maxBytes) {
+        truncated = true;
+    }
+    const consumed = start + slice.length;
+    const hasMore = consumed < items.length;
+    const nextPageNo = truncated ? null : hasMore ? pageNo + 1 : null;
+    return {
+        items: slice,
+        meta: {
+            pageNo,
+            pageSize,
+            returnedRows: slice.length,
+            hasMore,
+            nextPageNo,
+            // 가드로 잘렸으면 현재 pageSize로는 다음 페이지가 안전하지 않으므로(=항목 건너뛰기
+            // 손실), 이번에 들어간 건수를 회복용 pageSize로 제안한다.
+            ...(truncated ? { truncated: true, suggestedPageSize: Math.max(1, slice.length) } : {}),
+        },
+    };
+}
+//# sourceMappingURL=_response.js.map

package/dist/tools/_response.js.map

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