@airmcp-dev/cli 0.1.0

package/dist/commands/create.js

@@ -0,0 +1,150 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/create.ts
+//
+// air create <name> [--template basic|crud|api|agent] [--lang en|ko]
+//
+// 새 MCP 서버 프로젝트를 스캐폴딩한다.
+// 언어를 선택하면 해당 언어의 템플릿(주석/설명)이 적용된다.
+//
+// @example
+//   npx air create my-tool
+//   npx air create my-tool --lang ko
+//   npx air create db-server --template crud --lang en
+import { Command } from 'commander';
+import { cp, readFile, writeFile, access } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+import { createInterface } from 'node:readline';
+import { printer } from '../utils/printer.js';
+const TEMPLATES = ['basic', 'crud', 'api', 'agent'];
+/** 인터랙티브 언어 선택 */
+async function askLanguage() {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        console.log();
+        console.log('  Select language / 언어를 선택하세요:');
+        console.log();
+        console.log('    1) English');
+        console.log('    2) 한국어');
+        console.log();
+        rl.question('  > ', (answer) => {
+            rl.close();
+            const trimmed = answer.trim();
+            if (trimmed === '2' || trimmed.toLowerCase() === 'ko' || trimmed === '한국어') {
+                resolve('ko');
+            }
+            else {
+                resolve('en');
+            }
+        });
+    });
+}
+/** 언어별 메시지 */
+const MESSAGES = {
+    en: {
+        creating: (name) => `Creating MCP server: ${name}`,
+        copying: 'Copying template files...',
+        configuring: 'Configuring project...',
+        done: 'Done!',
+        created: (name, template) => `Project "${name}" created with "${template}" template.`,
+        nextSteps: 'Next steps:',
+    },
+    ko: {
+        creating: (name) => `MCP 서버 생성: ${name}`,
+        copying: '템플릿 파일 복사 중...',
+        configuring: '프로젝트 설정 중...',
+        done: '완료!',
+        created: (name, template) => `"${name}" 프로젝트가 "${template}" 템플릿으로 생성되었습니다.`,
+        nextSteps: '다음 단계:',
+    },
+};
+/** 템플릿 디렉토리 절대 경로 (빌드 후 dist/ 기준) */
+function templatesRoot() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    return resolve(__dirname, '..', 'templates');
+}
+export const createCommand = new Command('create')
+    .description('Create a new MCP server project')
+    .argument('<name>', 'Project name (directory name)')
+    .option('-t, --template <template>', 'Template to use', 'basic')
+    .option('-l, --lang <lang>', 'Language: en | ko')
+    .action(async (name, opts) => {
+    const template = opts.template;
+    // ── 1. 템플릿 유효성 검사 ──
+    if (!TEMPLATES.includes(template)) {
+        printer.error(`Unknown template "${template}". Available: ${TEMPLATES.join(', ')}`);
+        process.exit(1);
+    }
+    // ── 2. 언어 선택 ──
+    let lang;
+    if (opts.lang === 'ko' || opts.lang === 'en') {
+        lang = opts.lang;
+    }
+    else {
+        lang = await askLanguage();
+    }
+    const msg = MESSAGES[lang];
+    // ── 3. 대상 디렉토리 확인 ──
+    const targetDir = resolve(process.cwd(), name);
+    try {
+        await access(targetDir);
+        printer.error(`Directory "${name}" already exists.`);
+        process.exit(1);
+    }
+    catch {
+        // 존재하지 않으면 정상
+    }
+    const totalSteps = 3;
+    printer.blank();
+    printer.heading(msg.creating(name));
+    // ── 4. 언어별 템플릿 디렉토리 결정 ──
+    // ko면 basic-ko, en이면 basic
+    const templateDirName = lang === 'ko' ? `${template}-ko` : template;
+    let templateDir = join(templatesRoot(), templateDirName);
+    // 한글 템플릿이 없으면 영어로 폴백
+    try {
+        await access(templateDir);
+    }
+    catch {
+        templateDir = join(templatesRoot(), template);
+    }
+    try {
+        await access(templateDir);
+    }
+    catch {
+        printer.error(`Template "${template}" not found at ${templateDir}`);
+        process.exit(1);
+    }
+    // ── 5. 템플릿 복사 ──
+    printer.step(1, totalSteps, msg.copying);
+    await cp(templateDir, targetDir, { recursive: true });
+    // ── 6. package.json name 교체 ──
+    printer.step(2, totalSteps, msg.configuring);
+    const pkgPath = join(targetDir, 'package.json');
+    try {
+        const raw = await readFile(pkgPath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        pkg.name = name;
+        await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+    }
+    catch {
+        // package.json이 없는 템플릿이면 스킵
+    }
+    // ── 7. 완료 안내 ──
+    printer.step(3, totalSteps, msg.done);
+    printer.blank();
+    printer.success(msg.created(name, template));
+    printer.blank();
+    printer.info(msg.nextSteps);
+    printer.blank();
+    console.log(`  cd ${name}`);
+    console.log('  npm install');
+    console.log('  air dev');
+    printer.blank();
+});
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/dev.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const devCommand: Command;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+CpC,eAAO,MAAM,UAAU,SAwInB,CAAC"}

package/dist/commands/dev.js

@@ -0,0 +1,184 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/dev.ts
+//
+// air dev [--port <port>] [--transport stdio|http|sse]
+//
+// 개발 모드로 MCP 서버를 실행한다.
+// - 소스 변경 감지 → 자동 재시작 (fs.watch)
+// - 빌드 없이 tsx/ts-node로 직접 실행
+// - 종료 시 graceful shutdown
+//
+// @example
+//   air dev
+//   air dev --port 3100
+//   air dev --transport http
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import { watch } from 'node:fs';
+import { resolve, extname } from 'node:path';
+import { access } from 'node:fs/promises';
+import { printer } from '../utils/printer.js';
+/** 감시 대상 확장자 */
+const WATCH_EXTENSIONS = new Set(['.ts', '.js', '.json']);
+/** 재시작 디바운스 (ms) */
+const DEBOUNCE_MS = 300;
+/**
+ * 엔트리 파일을 찾는다.
+ * air.config.ts → src/index.ts → index.ts 순서.
+ */
+async function findEntry(cwd) {
+    const candidates = ['src/index.ts', 'src/index.js', 'index.ts', 'index.js'];
+    for (const candidate of candidates) {
+        const full = resolve(cwd, candidate);
+        try {
+            await access(full);
+            return full;
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error('No entry file found. Expected src/index.ts or index.ts');
+}
+/**
+ * tsx로 서버 프로세스를 실행한다.
+ * tsx가 없으면 ts-node/esm, 그것도 없으면 node 사용.
+ */
+function spawnServer(entry, env, cwd) {
+    const child = spawn('npx', ['tsx', entry], {
+        cwd,
+        stdio: 'inherit',
+        env: { ...process.env, ...env },
+        shell: true,
+    });
+    return child;
+}
+export const devCommand = new Command('dev')
+    .description('Start MCP server in development mode (hot reload)')
+    .option('-p, --port <port>', 'HTTP/SSE port', '3000')
+    .option('-t, --transport <type>', 'Transport: stdio | http | sse', 'stdio')
+    .option('-c, --console', 'Open interactive test console (requires SSE transport)')
+    .action(async (opts) => {
+    const cwd = process.cwd();
+    // 콘솔 모드는 SSE transport가 필요
+    if (opts.console && opts.transport === 'stdio') {
+        opts.transport = 'sse';
+        printer.info('Console mode requires SSE transport — switching to SSE.');
+    }
+    // ── 1. 엔트리 파일 찾기 ──
+    let entry;
+    try {
+        entry = await findEntry(cwd);
+    }
+    catch (err) {
+        printer.error(err.message);
+        process.exit(1);
+    }
+    const env = {
+        NODE_ENV: 'development',
+        AIR_TRANSPORT: opts.transport,
+        AIR_PORT: opts.port,
+    };
+    printer.blank();
+    printer.banner('dev');
+    printer.kv('entry', entry);
+    printer.kv('transport', opts.transport);
+    if (opts.transport !== 'stdio') {
+        printer.kv('port', opts.port);
+    }
+    if (opts.console) {
+        printer.kv('console', 'enabled');
+    }
+    printer.blank();
+    // ── 2. 서버 시작 ──
+    let child = null;
+    let restarting = false;
+    function startServer() {
+        printer.info('Starting server...');
+        child = spawnServer(entry, env, cwd);
+        child.on('exit', (code, signal) => {
+            if (!restarting) {
+                if (signal === 'SIGTERM' || signal === 'SIGINT') {
+                    printer.info('Server stopped.');
+                }
+                else if (code !== 0) {
+                    printer.error(`Server exited with code ${code}`);
+                }
+            }
+            child = null;
+        });
+    }
+    function stopServer() {
+        return new Promise((resolve) => {
+            if (!child) {
+                resolve();
+                return;
+            }
+            restarting = true;
+            child.once('exit', () => {
+                restarting = false;
+                resolve();
+            });
+            child.kill('SIGTERM');
+            // 강제 종료 타이머
+            setTimeout(() => {
+                if (child) {
+                    child.kill('SIGKILL');
+                }
+            }, 3000);
+        });
+    }
+    async function restart() {
+        printer.blank();
+        printer.info('Change detected, restarting...');
+        await stopServer();
+        startServer();
+    }
+    startServer();
+    // ── 3. 파일 감시 (디바운스) ──
+    let debounceTimer = null;
+    let watcher = null;
+    try {
+        const srcDir = resolve(cwd, 'src');
+        watcher = watch(srcDir, { recursive: true }, (_event, filename) => {
+            if (!filename)
+                return;
+            const ext = extname(filename);
+            if (!WATCH_EXTENSIONS.has(ext))
+                return;
+            if (debounceTimer)
+                clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => restart(), DEBOUNCE_MS);
+        });
+        printer.success('Watching src/ for changes...');
+    }
+    catch {
+        printer.warn('Could not watch src/ — hot reload disabled.');
+    }
+    // ── 4. 테스트 콘솔 (--console) ──
+    if (opts.console) {
+        // 서버가 뜰 시간 대기
+        const { startTestConsole } = await import('../utils/test-console.js');
+        await startTestConsole({
+            serverUrl: `http://localhost:${opts.port}`,
+            onQuit: async () => {
+                await shutdown();
+            },
+        });
+    }
+    // ── 5. Graceful shutdown ──
+    async function shutdown() {
+        printer.blank();
+        printer.info('Shutting down...');
+        if (watcher)
+            watcher.close();
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        await stopServer();
+        process.exit(0);
+    }
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+});
+;
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/disconnect.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const disconnectCommand: Command;
+//# sourceMappingURL=disconnect.d.ts.map

package/dist/commands/disconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.d.ts","sourceRoot":"","sources":["../../src/commands/disconnect.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,iBAAiB,SA8C1B,CAAC"}

package/dist/commands/disconnect.js

@@ -0,0 +1,69 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/disconnect.ts
+//
+// air disconnect <client> [--name <n>]
+//
+// MCP 클라이언트의 설정 파일에서 서버 등록을 제거한다.
+//
+// @example
+//   air disconnect claude-desktop
+//   air disconnect cursor --name my-db-tool
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { printer } from '../utils/printer.js';
+import { resolveClientConfig, listClients } from '../utils/path-resolver.js';
+import { JsonEditor } from '../utils/json-editor.js';
+/** package.json에서 서버 이름을 읽는다 */
+async function readServerName(cwd) {
+    try {
+        const raw = await readFile(resolve(cwd, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        return pkg.name || 'air-server';
+    }
+    catch {
+        return 'air-server';
+    }
+}
+export const disconnectCommand = new Command('disconnect')
+    .description('Remove this MCP server from a client')
+    .argument('<client>', 'Client to disconnect: claude-desktop, cursor, vscode, ...')
+    .option('-n, --name <n>', 'Server name to remove (default: from package.json)')
+    .action(async (client, opts) => {
+    const cwd = process.cwd();
+    // ── 1. 클라이언트 경로 해석 ──
+    let clientInfo;
+    try {
+        clientInfo = resolveClientConfig(client);
+    }
+    catch (err) {
+        printer.error(err.message);
+        printer.blank();
+        printer.info('Available clients:');
+        printer.blank();
+        printer.list(listClients().map((c) => ({ name: c.id, description: c.name })));
+        printer.blank();
+        process.exit(1);
+    }
+    // ── 2. 서버 이름 결정 ──
+    const serverName = opts.name || (await readServerName(cwd));
+    // ── 3. 설정 파일 로드 ──
+    printer.blank();
+    printer.step(1, 2, `Loading ${clientInfo.displayName} config...`);
+    const editor = await JsonEditor.load(clientInfo.configPath);
+    const entryPath = `${clientInfo.mcpKey}.${serverName}`;
+    // ── 4. 등록 제거 ──
+    if (!editor.has(entryPath)) {
+        printer.warn(`"${serverName}" is not registered in ${clientInfo.displayName}.`);
+        printer.blank();
+        return;
+    }
+    printer.step(2, 2, `Removing "${serverName}"...`);
+    editor.delete(entryPath);
+    await editor.save();
+    printer.blank();
+    printer.success(`Disconnected "${serverName}" from ${clientInfo.displayName}`);
+    printer.kv('config', clientInfo.configPath);
+    printer.blank();
+});
+//# sourceMappingURL=disconnect.js.map

package/dist/commands/disconnect.js.map

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

package/dist/commands/index.d.ts

@@ -0,0 +1,13 @@
+export { createCommand } from './create.js';
+export { addCommand } from './add.js';
+export { devCommand } from './dev.js';
+export { startCommand } from './start.js';
+export { stopCommand } from './stop.js';
+export { statusCommand } from './status.js';
+export { listCommand } from './list.js';
+export { inspectCommand } from './inspect.js';
+export { connectCommand } from './connect.js';
+export { disconnectCommand } from './disconnect.js';
+export { checkCommand } from './check.js';
+export { licenseCommand } from './license.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/commands/index.js

@@ -0,0 +1,16 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/index.ts
+// re-export only. 로직 없음.
+export { createCommand } from './create.js';
+export { addCommand } from './add.js';
+export { devCommand } from './dev.js';
+export { startCommand } from './start.js';
+export { stopCommand } from './stop.js';
+export { statusCommand } from './status.js';
+export { listCommand } from './list.js';
+export { inspectCommand } from './inspect.js';
+export { connectCommand } from './connect.js';
+export { disconnectCommand } from './disconnect.js';
+export { checkCommand } from './check.js';
+export { licenseCommand } from './license.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,8BAA8B;AAC9B,yBAAyB;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/commands/inspect.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const inspectCommand: Command;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/commands/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwEpC,eAAO,MAAM,cAAc,SA2FvB,CAAC"}

package/dist/commands/inspect.js

@@ -0,0 +1,159 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/inspect.ts
+//
+// air inspect <tool>
+//
+// 특정 도구의 상세 스키마를 출력한다.
+// - 파라미터 이름, 타입, 설명, 필수 여부
+// - JSON 스키마 형태로도 출력 가능 (--json)
+//
+// @example
+//   air inspect hello
+//   air inspect search --json
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { access } from 'node:fs/promises';
+import { printer } from '../utils/printer.js';
+/** 엔트리 파일 탐색 */
+async function findEntry(cwd) {
+    const candidates = ['src/index.ts', 'src/index.js', 'dist/index.js', 'index.ts', 'index.js'];
+    for (const candidate of candidates) {
+        const full = resolve(cwd, candidate);
+        try {
+            await access(full);
+            return full;
+        }
+        catch {
+            continue;
+        }
+    }
+    throw new Error('No entry file found. Expected src/index.ts or index.ts');
+}
+/** zod 스키마에서 파라미터 정보를 추출한다 */
+function extractParams(schema) {
+    const params = [];
+    if (!schema || !schema.shape)
+        return params;
+    const shape = schema.shape;
+    for (const [key, field] of Object.entries(shape)) {
+        let type = 'unknown';
+        let required = true;
+        let description;
+        // zod 타입 추출
+        if (field?._def) {
+            const typeName = field._def.typeName;
+            if (typeName === 'ZodString')
+                type = 'string';
+            else if (typeName === 'ZodNumber')
+                type = 'number';
+            else if (typeName === 'ZodBoolean')
+                type = 'boolean';
+            else if (typeName === 'ZodArray')
+                type = 'array';
+            else if (typeName === 'ZodObject')
+                type = 'object';
+            else if (typeName === 'ZodEnum')
+                type = `enum(${field._def.values?.join('|')})`;
+            else if (typeName === 'ZodOptional') {
+                required = false;
+                // 내부 타입 확인
+                const inner = field._def.innerType?._def?.typeName;
+                if (inner === 'ZodString')
+                    type = 'string';
+                else if (inner === 'ZodNumber')
+                    type = 'number';
+                else if (inner === 'ZodBoolean')
+                    type = 'boolean';
+                else
+                    type = inner?.replace('Zod', '').toLowerCase() || 'any';
+            }
+            description = field._def.description || field.description;
+        }
+        params.push({ name: key, type, required, description });
+    }
+    return params;
+}
+export const inspectCommand = new Command('inspect')
+    .description("Inspect a tool's schema and parameters")
+    .argument('<tool>', 'Tool name to inspect')
+    .option('--json', 'Output as JSON schema', false)
+    .action(async (toolName, opts) => {
+    const cwd = process.cwd();
+    // ── 1. 엔트리 로드 ──
+    let entry;
+    try {
+        entry = await findEntry(cwd);
+    }
+    catch (err) {
+        printer.error(err.message);
+        process.exit(1);
+    }
+    let server;
+    try {
+        const mod = await import(entry);
+        server = mod.default || mod;
+    }
+    catch (err) {
+        printer.error(`Failed to load server: ${err.message}`);
+        process.exit(1);
+    }
+    // ── 2. 도구 찾기 ──
+    if (typeof server.tools !== 'function') {
+        printer.error('Server does not expose tools().');
+        process.exit(1);
+    }
+    const tools = server.tools();
+    const tool = tools.find((t) => t.name === toolName);
+    if (!tool) {
+        printer.error(`Tool "${toolName}" not found.`);
+        printer.blank();
+        printer.info('Available tools:');
+        printer.blank();
+        printer.list(tools.map((t) => ({ name: t.name, description: t.description })));
+        printer.blank();
+        process.exit(1);
+    }
+    // ── 3. JSON 출력 ──
+    if (opts.json) {
+        const output = {
+            name: tool.name,
+            description: tool.description,
+        };
+        // JSON Schema 변환 시도
+        if (tool.schema && typeof tool.schema.toJsonSchema === 'function') {
+            output.inputSchema = tool.schema.toJsonSchema();
+        }
+        else if (tool.jsonSchema) {
+            output.inputSchema = tool.jsonSchema;
+        }
+        else {
+            output.inputSchema = null;
+        }
+        console.log(JSON.stringify(output, null, 2));
+        return;
+    }
+    // ── 4. 사람용 출력 ──
+    printer.blank();
+    printer.heading(tool.name);
+    if (tool.description) {
+        printer.kv('description', tool.description);
+    }
+    // 파라미터 추출
+    const params = extractParams(tool.schema);
+    if (params.length > 0) {
+        printer.blank();
+        printer.info(`Parameters (${params.length}):`);
+        printer.blank();
+        for (const p of params) {
+            const req = p.required ? ' *' : '';
+            const desc = p.description ? `  ${p.description}` : '';
+            console.log(`  ${p.name}${req}  (${p.type})${desc}`);
+        }
+    }
+    else {
+        printer.blank();
+        printer.info('No parameters.');
+    }
+    printer.blank();
+});
+//# sourceMappingURL=inspect.js.map