@airmcp-dev/cli 0.1.0

package/dist/utils/test-console.js

@@ -0,0 +1,198 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — utils/test-console.ts
+//
+// 내장 인터랙티브 테스트 콘솔.
+// air dev 실행 시 서버에 MCP 클라이언트로 연결하여
+// 도구를 직접 호출하고 결과를 확인할 수 있다.
+//
+// 명령어:
+//   tools          — 도구 목록
+//   call <name> [key=value ...]  — 도구 호출
+//   resources      — 리소스 목록
+//   status         — 서버 상태
+//   help           — 도움말
+//   quit           — 종료
+import { createInterface } from 'node:readline';
+/** 파라미터 파싱: "key=value key2=value2" → { key: value, key2: value2 } */
+function parseArgs(tokens) {
+    const args = {};
+    for (const token of tokens) {
+        const eqIdx = token.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = token.slice(0, eqIdx);
+        let value = token.slice(eqIdx + 1);
+        // 숫자 변환
+        if (/^\d+(\.\d+)?$/.test(value))
+            value = Number(value);
+        // boolean
+        else if (value === 'true')
+            value = true;
+        else if (value === 'false')
+            value = false;
+        // 따옴표 제거
+        else if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        args[key] = value;
+    }
+    return args;
+}
+/** SSE 클라이언트로 서버에 연결하여 테스트 콘솔 제공 */
+export async function startTestConsole(options) {
+    const { Client } = await import('@modelcontextprotocol/sdk/client/index.js');
+    const { SSEClientTransport } = await import('@modelcontextprotocol/sdk/client/sse.js');
+    let client = null;
+    // SSE 연결 시도 (서버가 준비될 때까지 재시도)
+    async function connect() {
+        for (let attempt = 0; attempt < 10; attempt++) {
+            try {
+                const transport = new SSEClientTransport(new URL(`${options.serverUrl}/sse`));
+                client = new Client({ name: 'air-dev-console', version: '1.0.0' });
+                await client.connect(transport);
+                return true;
+            }
+            catch {
+                await new Promise((r) => setTimeout(r, 1000));
+            }
+        }
+        return false;
+    }
+    console.log('\n  \x1b[36m⚡ air dev console\x1b[0m — type "help" for commands\n');
+    console.log('  Connecting to server...');
+    const connected = await connect();
+    if (!connected || !client) {
+        console.log('  \x1b[31m✖ Could not connect to server\x1b[0m');
+        console.log('  Make sure the server is running with SSE transport.\n');
+        return;
+    }
+    console.log('  \x1b[32m✔ Connected!\x1b[0m\n');
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+        prompt: '  \x1b[36mair>\x1b[0m ',
+    });
+    rl.prompt();
+    rl.on('line', async (line) => {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            rl.prompt();
+            return;
+        }
+        const [cmd, ...rest] = trimmed.split(/\s+/);
+        try {
+            switch (cmd) {
+                case 'help':
+                case 'h':
+                case '?': {
+                    console.log(`
+  \x1b[1mCommands:\x1b[0m
+    tools                         List all tools
+    call <name> [key=value ...]   Call a tool with arguments
+    resources                     List resources
+    prompts                       List prompts
+    status                        Server status
+    help                          Show this help
+    quit                          Exit console
+`);
+                    break;
+                }
+                case 'tools':
+                case 't': {
+                    const result = await client.listTools();
+                    console.log(`\n  📋 Tools (${result.tools.length}):\n`);
+                    for (const tool of result.tools) {
+                        const params = tool.inputSchema?.properties
+                            ? Object.keys(tool.inputSchema.properties).join(', ')
+                            : 'none';
+                        console.log(`    \x1b[33m${tool.name}\x1b[0m (${params})`);
+                        if (tool.description)
+                            console.log(`      ${tool.description}`);
+                    }
+                    console.log();
+                    break;
+                }
+                case 'call':
+                case 'c': {
+                    if (rest.length === 0) {
+                        console.log('  Usage: call <tool_name> [key=value ...]');
+                        break;
+                    }
+                    const toolName = rest[0];
+                    const args = parseArgs(rest.slice(1));
+                    console.log(`  → ${toolName}(${JSON.stringify(args)})`);
+                    const start = Date.now();
+                    const result = await client.callTool({ name: toolName, arguments: args });
+                    const elapsed = Date.now() - start;
+                    const content = result.content;
+                    for (const item of content) {
+                        if (item.text) {
+                            console.log(`  \x1b[32m←\x1b[0m ${item.text} \x1b[90m(${elapsed}ms)\x1b[0m`);
+                        }
+                    }
+                    if (result.isError) {
+                        console.log(`  \x1b[31m⚠ Error response\x1b[0m`);
+                    }
+                    console.log();
+                    break;
+                }
+                case 'resources':
+                case 'r': {
+                    const result = await client.listResources();
+                    console.log(`\n  📁 Resources (${result.resources.length}):\n`);
+                    for (const res of result.resources) {
+                        console.log(`    ${res.name}: ${res.uri}`);
+                    }
+                    console.log();
+                    break;
+                }
+                case 'prompts':
+                case 'p': {
+                    const result = await client.listPrompts();
+                    console.log(`\n  💬 Prompts (${result.prompts.length}):\n`);
+                    for (const p of result.prompts) {
+                        console.log(`    ${p.name}: ${p.description || ''}`);
+                    }
+                    console.log();
+                    break;
+                }
+                case 'status':
+                case 's': {
+                    try {
+                        const res = await fetch(options.serverUrl);
+                        const data = await res.json();
+                        console.log(`\n  📊 Server Status:\n`);
+                        for (const [k, v] of Object.entries(data)) {
+                            console.log(`    ${k}: ${v}`);
+                        }
+                        console.log();
+                    }
+                    catch {
+                        console.log('  Could not fetch server status.\n');
+                    }
+                    break;
+                }
+                case 'quit':
+                case 'q':
+                case 'exit': {
+                    rl.close();
+                    if (client)
+                        await client.close();
+                    options.onQuit();
+                    return;
+                }
+                default:
+                    console.log(`  Unknown command: "${cmd}". Type "help" for available commands.\n`);
+            }
+        }
+        catch (err) {
+            console.log(`  \x1b[31m✖ ${err.message}\x1b[0m\n`);
+        }
+        rl.prompt();
+    });
+    rl.on('close', () => {
+        if (client)
+            client.close().catch(() => { });
+    });
+}
+//# sourceMappingURL=test-console.js.map

package/dist/utils/test-console.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@airmcp-dev/cli",
+  "version": "0.1.0",
+  "description": "CLI for air — build, run, and manage MCP servers",
+  "type": "module",
+  "bin": {
+    "airmcp-dev": "./dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc && rm -rf dist/templates && cp -r src/templates dist/templates",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@airmcp-dev/core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "cli",
+    "model-context-protocol",
+    "ai",
+    "tool-server"
+  ],
+  "author": "CodePedia Labs",
+  "homepage": "https://airmcp.dev",
+  "bugs": { "url": "https://github.com/airmcp-dev/air/issues" },
+  "repository": { "type": "git", "url": "https://github.com/airmcp-dev/air", "directory": "packages/cli" },
+  "keywords": ["mcp", "ai", "agent", "air"],
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/airmcp-dev/air",
+    "directory": "packages/cli"
+  }
+}