@airmcp-dev/cli 0.1.0

package/dist/templates/agent/.ai/context.md

@@ -0,0 +1,36 @@
+# air MCP Server -- AI Context
+
+This project is an MCP server built with the air framework.
+
+## Stack
+- TypeScript + Node.js
+- @airmcp-dev/core for server definition
+- MCP protocol (JSON-RPC 2.0)
+
+## Key APIs
+- defineServer({ name, tools, resources, prompts, use, shield, meter })
+- defineTool(name, { params, handler })
+- defineResource({ uri, name, handler })
+- definePrompt(name, { args, handler })
+
+## Adding Features
+- Add tool: `air add tool <name> --params "key:type"`
+- Add resource: `air add resource <name>`
+- Add prompt: `air add prompt <name>`
+
+## Plugins (import from @airmcp-dev/core)
+timeoutPlugin, retryPlugin, circuitBreakerPlugin, fallbackPlugin,
+cachePlugin, dedupPlugin, queuePlugin,
+authPlugin, sanitizerPlugin, validatorPlugin,
+corsPlugin, webhookPlugin, transformPlugin, i18nPlugin,
+jsonLoggerPlugin, perUserRateLimitPlugin, dryrunPlugin
+
+## Transport
+- stdio (default): for Claude Desktop direct execution
+- sse: for remote connections (set transport.type and transport.port)
+- http: for Streamable HTTP
+
+## Commands
+- `air dev --console` -- dev mode with test console
+- `air connect claude-desktop` -- register with client
+- `air check` -- project diagnostics

package/dist/templates/agent/.vscode/air.code-snippets

@@ -0,0 +1,178 @@
+{
+  // ═══════════════════════════════════════════
+  //  air — MCP Server Development Snippets
+  // ═══════════════════════════════════════════
+
+  "air: defineServer": {
+    "prefix": "airserver",
+    "description": "Create a new MCP server with air",
+    "body": [
+      "import { defineServer, defineTool } from '@air/core';",
+      "",
+      "export default defineServer({",
+      "  name: '${1:my-server}',",
+      "  version: '${2:0.1.0}',",
+      "  description: '${3:MCP server description}',",
+      "",
+      "  shield: {",
+      "    enabled: ${4|true,false|},",
+      "    threatDetection: true,",
+      "  },",
+      "",
+      "  meter: {",
+      "    enabled: true,",
+      "    classify: true,",
+      "    trackCalls: true,",
+      "  },",
+      "",
+      "  tools: [",
+      "    $0",
+      "  ],",
+      "});"
+    ]
+  },
+
+  "air: defineTool": {
+    "prefix": "airtool",
+    "description": "Define a new MCP tool",
+    "body": [
+      "defineTool('${1:tool_name}', {",
+      "  description: '${2:Tool description}',",
+      "  params: {",
+      "    ${3:param}: { type: '${4|string,number,boolean,object|}', description: '${5:param description}' },",
+      "  },",
+      "  handler: async ({ ${3:param} }) => {",
+      "    $0",
+      "    return '${6:result}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: defineTool (no params)": {
+    "prefix": "airtool0",
+    "description": "Define a tool with no parameters",
+    "body": [
+      "defineTool('${1:tool_name}', {",
+      "  description: '${2:Tool description}',",
+      "  params: {},",
+      "  handler: async () => {",
+      "    $0",
+      "    return '${3:result}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: defineTool (multi params)": {
+    "prefix": "airtoolm",
+    "description": "Define a tool with multiple parameters",
+    "body": [
+      "defineTool('${1:tool_name}', {",
+      "  description: '${2:Tool description}',",
+      "  params: {",
+      "    ${3:param1}: { type: 'string', description: '${4:first param}' },",
+      "    ${5:param2}: { type: 'string', description: '${6:second param}' },",
+      "  },",
+      "  handler: async ({ ${3:param1}, ${5:param2} }) => {",
+      "    $0",
+      "    return '${7:result}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: defineResource": {
+    "prefix": "airresource",
+    "description": "Define an MCP resource",
+    "body": [
+      "defineResource({",
+      "  name: '${1:resource_name}',",
+      "  uri: '${2:resource://path}',",
+      "  description: '${3:Resource description}',",
+      "  handler: async (uri, ctx) => {",
+      "    $0",
+      "    return '${4:content}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: definePrompt": {
+    "prefix": "airprompt",
+    "description": "Define an MCP prompt template",
+    "body": [
+      "definePrompt({",
+      "  name: '${1:prompt_name}',",
+      "  description: '${2:Prompt description}',",
+      "  args: [",
+      "    { name: '${3:arg}', description: '${4:arg description}' },",
+      "  ],",
+      "  handler: async ({ ${3:arg} }) => [",
+      "    { role: 'user', content: `${5:prompt text \\${${3:arg}\\}}` },",
+      "  ],",
+      "}),"
+    ]
+  },
+
+  "air: shield config": {
+    "prefix": "airshield",
+    "description": "Add shield (security) configuration",
+    "body": [
+      "shield: {",
+      "  enabled: true,",
+      "  policies: [",
+      "    { name: '${1:policy_name}', target: '${2:*}', action: '${3|allow,deny|}', priority: ${4:10} },",
+      "  ],",
+      "  threatDetection: true,",
+      "  rateLimit: {",
+      "    maxCalls: ${5:100},",
+      "    windowMs: ${6:60000},",
+      "  },",
+      "  audit: true,",
+      "},"
+    ]
+  },
+
+  "air: meter config": {
+    "prefix": "airmeter",
+    "description": "Add meter (metrics) configuration",
+    "body": [
+      "meter: {",
+      "  enabled: true,",
+      "  classify: true,",
+      "  trackCalls: true,",
+      "},"
+    ]
+  },
+
+  "air: import core": {
+    "prefix": "airimport",
+    "description": "Import air/core essentials",
+    "body": [
+      "import { defineServer, defineTool${1:, getAuditLog, getMetricsSnapshot} } from '@air/core';"
+    ]
+  },
+
+  "air: import all": {
+    "prefix": "airimportall",
+    "description": "Import from all air packages",
+    "body": [
+      "import { defineServer, defineTool, getAuditLog, getMetricsSnapshot } from '@air/core';",
+      "import { AirLogger, PrettyFormatter, ConsoleTransport } from '@air/logger';",
+      "import { PolicyEngine, ThreatDetector, RateLimiter } from '@air/shield';",
+      "import { LayerClassifier, CallTracker } from '@air/meter';"
+    ]
+  },
+
+  "air: handler async": {
+    "prefix": "airhandler",
+    "description": "Async handler function for a tool",
+    "body": [
+      "handler: async ({ ${1:params} }) => {",
+      "  $0",
+      "  return '${2:result}';",
+      "},"
+    ]
+  }
+}

package/dist/templates/agent/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "my-agent-server",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "air dev",
+    "start": "air start",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@airmcp-dev/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}

package/dist/templates/agent/src/index.ts

@@ -0,0 +1,98 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-agent-server — src/index.ts
+//
+// AI 에이전트 도구 서버 템플릿.
+// think + execute + remember 패턴.
+// LLM 호출 없이 구조만 제공 — 사용자가 LLM 연동을 추가.
+
+import { defineServer, defineTool, createStorage } from '@airmcp-dev/core';
+
+// 에이전트 메모리 (인메모리, 실제로는 벡터DB 등으로 교체)
+const memory = createStorage({ adapter: 'memory' });
+
+const server = defineServer({
+  name: 'my-agent-server',
+  version: '0.1.0',
+
+  // transport: { type: 'sse', port: 3510 },
+  description: 'AI agent with think-execute-remember pattern',
+
+  tools: [
+    defineTool('think', {
+      description: 'Analyze a problem and produce a plan',
+      params: {
+        problem: { type: 'string', description: 'Problem statement or question' },
+        context: { type: 'string', description: 'Additional context (optional)', optional: true },
+      },
+      handler: async ({ problem, context }) => {
+        // TODO: 여기에 LLM 호출을 연결
+        // const plan = await llm.generate(`Analyze: ${problem}\nContext: ${context}`);
+        const plan = {
+          problem,
+          steps: [
+            'Step 1: Understand the problem',
+            'Step 2: Gather relevant data',
+            'Step 3: Execute solution',
+            'Step 4: Verify result',
+          ],
+          reasoning: 'Replace this with LLM-generated reasoning',
+        };
+
+        // 사고 과정을 메모리에 저장
+        const id = `thought_${Date.now()}`;
+        await memory.set(id, { ...plan, timestamp: new Date().toISOString() });
+
+        return plan;
+      },
+    }),
+
+    defineTool('execute', {
+      description: 'Execute a step from the plan',
+      params: {
+        step: { type: 'string', description: 'Step description to execute' },
+        input: { type: 'string', description: 'Input data for the step (optional)', optional: true },
+      },
+      handler: async ({ step, input }) => {
+        // TODO: 여기에 실제 실행 로직을 연결
+        // 파일 조작, API 호출, DB 쿼리 등
+        const result = {
+          step,
+          status: 'completed',
+          output: `Executed: ${step}`,
+          timestamp: new Date().toISOString(),
+        };
+
+        // 실행 결과를 메모리에 저장
+        const id = `exec_${Date.now()}`;
+        await memory.set(id, result);
+
+        return result;
+      },
+    }),
+
+    defineTool('remember', {
+      description: 'Store or recall information from agent memory',
+      params: {
+        action: { type: 'string', description: '"store" or "recall"' },
+        key: { type: 'string', description: 'Memory key' },
+        value: { type: 'string', description: 'Value to store (for store action)', optional: true },
+      },
+      handler: async ({ action, key, value }) => {
+        if (action === 'store' && value) {
+          await memory.set(key, { value, timestamp: new Date().toISOString() });
+          return { action: 'stored', key };
+        }
+
+        if (action === 'recall') {
+          const data = await memory.get(key);
+          if (!data) return { action: 'recall', key, found: false };
+          return { action: 'recall', key, found: true, data };
+        }
+
+        return { error: 'Invalid action. Use "store" or "recall".' };
+      },
+    }),
+  ],
+});
+
+server.start();

package/dist/templates/agent/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src"]
+}

package/dist/templates/agent-ko/.ai/context.md

@@ -0,0 +1,36 @@
+# air MCP Server -- AI Context
+
+This project is an MCP server built with the air framework.
+
+## Stack
+- TypeScript + Node.js
+- @airmcp-dev/core for server definition
+- MCP protocol (JSON-RPC 2.0)
+
+## Key APIs
+- defineServer({ name, tools, resources, prompts, use, shield, meter })
+- defineTool(name, { params, handler })
+- defineResource({ uri, name, handler })
+- definePrompt(name, { args, handler })
+
+## Adding Features
+- Add tool: `air add tool <name> --params "key:type"`
+- Add resource: `air add resource <name>`
+- Add prompt: `air add prompt <name>`
+
+## Plugins (import from @airmcp-dev/core)
+timeoutPlugin, retryPlugin, circuitBreakerPlugin, fallbackPlugin,
+cachePlugin, dedupPlugin, queuePlugin,
+authPlugin, sanitizerPlugin, validatorPlugin,
+corsPlugin, webhookPlugin, transformPlugin, i18nPlugin,
+jsonLoggerPlugin, perUserRateLimitPlugin, dryrunPlugin
+
+## Transport
+- stdio (default): for Claude Desktop direct execution
+- sse: for remote connections (set transport.type and transport.port)
+- http: for Streamable HTTP
+
+## Commands
+- `air dev --console` -- dev mode with test console
+- `air connect claude-desktop` -- register with client
+- `air check` -- project diagnostics

package/dist/templates/agent-ko/.vscode/air.code-snippets

@@ -0,0 +1,178 @@
+{
+  // ═══════════════════════════════════════════
+  //  air — MCP Server Development Snippets
+  // ═══════════════════════════════════════════
+
+  "air: defineServer": {
+    "prefix": "airserver",
+    "description": "Create a new MCP server with air",
+    "body": [
+      "import { defineServer, defineTool } from '@air/core';",
+      "",
+      "export default defineServer({",
+      "  name: '${1:my-server}',",
+      "  version: '${2:0.1.0}',",
+      "  description: '${3:MCP server description}',",
+      "",
+      "  shield: {",
+      "    enabled: ${4|true,false|},",
+      "    threatDetection: true,",
+      "  },",
+      "",
+      "  meter: {",
+      "    enabled: true,",
+      "    classify: true,",
+      "    trackCalls: true,",
+      "  },",
+      "",
+      "  tools: [",
+      "    $0",
+      "  ],",
+      "});"
+    ]
+  },
+
+  "air: defineTool": {
+    "prefix": "airtool",
+    "description": "Define a new MCP tool",
+    "body": [
+      "defineTool('${1:tool_name}', {",
+      "  description: '${2:Tool description}',",
+      "  params: {",
+      "    ${3:param}: { type: '${4|string,number,boolean,object|}', description: '${5:param description}' },",
+      "  },",
+      "  handler: async ({ ${3:param} }) => {",
+      "    $0",
+      "    return '${6:result}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: defineTool (no params)": {
+    "prefix": "airtool0",
+    "description": "Define a tool with no parameters",
+    "body": [
+      "defineTool('${1:tool_name}', {",
+      "  description: '${2:Tool description}',",
+      "  params: {},",
+      "  handler: async () => {",
+      "    $0",
+      "    return '${3:result}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: defineTool (multi params)": {
+    "prefix": "airtoolm",
+    "description": "Define a tool with multiple parameters",
+    "body": [
+      "defineTool('${1:tool_name}', {",
+      "  description: '${2:Tool description}',",
+      "  params: {",
+      "    ${3:param1}: { type: 'string', description: '${4:first param}' },",
+      "    ${5:param2}: { type: 'string', description: '${6:second param}' },",
+      "  },",
+      "  handler: async ({ ${3:param1}, ${5:param2} }) => {",
+      "    $0",
+      "    return '${7:result}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: defineResource": {
+    "prefix": "airresource",
+    "description": "Define an MCP resource",
+    "body": [
+      "defineResource({",
+      "  name: '${1:resource_name}',",
+      "  uri: '${2:resource://path}',",
+      "  description: '${3:Resource description}',",
+      "  handler: async (uri, ctx) => {",
+      "    $0",
+      "    return '${4:content}';",
+      "  },",
+      "}),"
+    ]
+  },
+
+  "air: definePrompt": {
+    "prefix": "airprompt",
+    "description": "Define an MCP prompt template",
+    "body": [
+      "definePrompt({",
+      "  name: '${1:prompt_name}',",
+      "  description: '${2:Prompt description}',",
+      "  args: [",
+      "    { name: '${3:arg}', description: '${4:arg description}' },",
+      "  ],",
+      "  handler: async ({ ${3:arg} }) => [",
+      "    { role: 'user', content: `${5:prompt text \\${${3:arg}\\}}` },",
+      "  ],",
+      "}),"
+    ]
+  },
+
+  "air: shield config": {
+    "prefix": "airshield",
+    "description": "Add shield (security) configuration",
+    "body": [
+      "shield: {",
+      "  enabled: true,",
+      "  policies: [",
+      "    { name: '${1:policy_name}', target: '${2:*}', action: '${3|allow,deny|}', priority: ${4:10} },",
+      "  ],",
+      "  threatDetection: true,",
+      "  rateLimit: {",
+      "    maxCalls: ${5:100},",
+      "    windowMs: ${6:60000},",
+      "  },",
+      "  audit: true,",
+      "},"
+    ]
+  },
+
+  "air: meter config": {
+    "prefix": "airmeter",
+    "description": "Add meter (metrics) configuration",
+    "body": [
+      "meter: {",
+      "  enabled: true,",
+      "  classify: true,",
+      "  trackCalls: true,",
+      "},"
+    ]
+  },
+
+  "air: import core": {
+    "prefix": "airimport",
+    "description": "Import air/core essentials",
+    "body": [
+      "import { defineServer, defineTool${1:, getAuditLog, getMetricsSnapshot} } from '@air/core';"
+    ]
+  },
+
+  "air: import all": {
+    "prefix": "airimportall",
+    "description": "Import from all air packages",
+    "body": [
+      "import { defineServer, defineTool, getAuditLog, getMetricsSnapshot } from '@air/core';",
+      "import { AirLogger, PrettyFormatter, ConsoleTransport } from '@air/logger';",
+      "import { PolicyEngine, ThreatDetector, RateLimiter } from '@air/shield';",
+      "import { LayerClassifier, CallTracker } from '@air/meter';"
+    ]
+  },
+
+  "air: handler async": {
+    "prefix": "airhandler",
+    "description": "Async handler function for a tool",
+    "body": [
+      "handler: async ({ ${1:params} }) => {",
+      "  $0",
+      "  return '${2:result}';",
+      "},"
+    ]
+  }
+}

package/dist/templates/agent-ko/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "my-agent-server",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "air dev",
+    "start": "air start",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@airmcp-dev/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}

package/dist/templates/agent-ko/src/index.ts

@@ -0,0 +1,92 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-agent-server — src/index.ts
+//
+// AI 에이전트 도구 서버 템플릿.
+// 생각(think) + 실행(execute) + 기억(remember) 패턴.
+// LLM 연동은 직접 추가하세요.
+
+import { defineServer, defineTool, createStorage } from '@airmcp-dev/core';
+
+// 에이전트 메모리 (인메모리, 실제로는 벡터DB 등으로 교체하세요)
+const memory = createStorage({ adapter: 'memory' });
+
+const server = defineServer({
+  name: 'my-agent-server',
+  version: '0.1.0',
+
+  // transport: { type: 'sse', port: 3510 },
+  description: '생각-실행-기억 패턴의 AI 에이전트 서버',
+
+  tools: [
+    defineTool('think', {
+      description: '문제를 분석하고 실행 계획을 세웁니다',
+      params: {
+        problem: { type: 'string', description: '문제 또는 질문' },
+        context: { type: 'string', description: '추가 맥락 (선택)', optional: true },
+      },
+      handler: async ({ problem, context }) => {
+        // TODO: 여기에 LLM 호출을 연결하세요
+        const plan = {
+          problem,
+          steps: [
+            '1단계: 문제 이해',
+            '2단계: 관련 데이터 수집',
+            '3단계: 해결책 실행',
+            '4단계: 결과 검증',
+          ],
+          reasoning: 'LLM 추론 결과로 교체하세요',
+        };
+
+        const id = `thought_${Date.now()}`;
+        await memory.set(id, { ...plan, timestamp: new Date().toISOString() });
+        return plan;
+      },
+    }),
+
+    defineTool('execute', {
+      description: '계획의 단계를 실행합니다',
+      params: {
+        step: { type: 'string', description: '실행할 단계 설명' },
+        input: { type: 'string', description: '입력 데이터 (선택)', optional: true },
+      },
+      handler: async ({ step, input }) => {
+        // TODO: 여기에 실제 실행 로직을 연결하세요
+        const result = {
+          step,
+          status: '완료',
+          output: `실행됨: ${step}`,
+          timestamp: new Date().toISOString(),
+        };
+
+        const id = `exec_${Date.now()}`;
+        await memory.set(id, result);
+        return result;
+      },
+    }),
+
+    defineTool('remember', {
+      description: '에이전트 메모리에 정보를 저장하거나 불러옵니다',
+      params: {
+        action: { type: 'string', description: '"store" 또는 "recall"' },
+        key: { type: 'string', description: '메모리 키' },
+        value: { type: 'string', description: '저장할 값 (store 시)', optional: true },
+      },
+      handler: async ({ action, key, value }) => {
+        if (action === 'store' && value) {
+          await memory.set(key, { value, timestamp: new Date().toISOString() });
+          return { action: '저장됨', key };
+        }
+
+        if (action === 'recall') {
+          const data = await memory.get(key);
+          if (!data) return { action: '조회', key, found: false };
+          return { action: '조회', key, found: true, data };
+        }
+
+        return { error: '올바르지 않은 action입니다. "store" 또는 "recall"을 사용하세요.' };
+      },
+    }),
+  ],
+});
+
+server.start();

package/dist/templates/agent-ko/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src"]
+}