@airmcp-dev/cli 0.1.0

package/dist/templates/crud/.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/crud/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "my-crud-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/crud/src/index.ts

@@ -0,0 +1,82 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-crud-server — src/index.ts
+//
+// DB CRUD 도구 서버 템플릿.
+// 4개 도구(create, read, update, delete)를 제공한다.
+// 실제 DB 연결은 사용자가 구현.
+
+import { defineServer, defineTool, createStorage } from '@airmcp-dev/core';
+
+// 인메모리 스토리지 (개발용, 실제로는 DB로 교체)
+const store = createStorage({ adapter: 'memory' });
+
+const server = defineServer({
+  name: 'my-crud-server',
+  version: '0.1.0',
+
+  // transport: { type: 'sse', port: 3510 },
+  description: 'CRUD operations for your data',
+
+  tools: [
+    defineTool('create', {
+      description: 'Create a new record',
+      params: {
+        collection: { type: 'string', description: 'Collection/table name' },
+        data: { type: 'string', description: 'JSON string of record data' },
+      },
+      handler: async ({ collection, data }) => {
+        const record = JSON.parse(data);
+        const id = `${collection}_${Date.now()}`;
+        await store.set(id, { ...record, _id: id, _collection: collection });
+        return { id, message: `Created in ${collection}` };
+      },
+    }),
+
+    defineTool('read', {
+      description: 'Read records from a collection',
+      params: {
+        collection: { type: 'string', description: 'Collection/table name' },
+        id: { type: 'string', description: 'Record ID (optional, omit for all)', optional: true },
+      },
+      handler: async ({ collection, id }) => {
+        if (id) {
+          const record = await store.get(id);
+          return record || { error: 'Not found' };
+        }
+        // 전체 조회 (인메모리 한정)
+        const all = await store.list({ prefix: `${collection}_` });
+        return { collection, count: all.length, records: all };
+      },
+    }),
+
+    defineTool('update', {
+      description: 'Update an existing record',
+      params: {
+        id: { type: 'string', description: 'Record ID' },
+        data: { type: 'string', description: 'JSON string of fields to update' },
+      },
+      handler: async ({ id, data }) => {
+        const existing = await store.get(id);
+        if (!existing) return { error: 'Not found' };
+        const updated = { ...existing, ...JSON.parse(data) };
+        await store.set(id, updated);
+        return { id, message: 'Updated', record: updated };
+      },
+    }),
+
+    defineTool('delete', {
+      description: 'Delete a record',
+      params: {
+        id: { type: 'string', description: 'Record ID' },
+      },
+      handler: async ({ id }) => {
+        const existing = await store.get(id);
+        if (!existing) return { error: 'Not found' };
+        await store.delete(id);
+        return { id, message: 'Deleted' };
+      },
+    }),
+  ],
+});
+
+server.start();

package/dist/templates/crud/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/crud-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/crud-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/crud-ko/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "my-crud-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/crud-ko/src/index.ts

@@ -0,0 +1,81 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-crud-server — src/index.ts
+//
+// DB CRUD 도구 서버 템플릿.
+// 4개 도구(생성, 조회, 수정, 삭제)를 제공합니다.
+// 실제 DB 연결은 직접 구현하세요.
+
+import { defineServer, defineTool, createStorage } from '@airmcp-dev/core';
+
+// 인메모리 스토리지 (개발용, 실제로는 DB로 교체하세요)
+const store = createStorage({ adapter: 'memory' });
+
+const server = defineServer({
+  name: 'my-crud-server',
+  version: '0.1.0',
+
+  // transport: { type: 'sse', port: 3510 },
+  description: '데이터 CRUD 도구 서버',
+
+  tools: [
+    defineTool('create', {
+      description: '새 레코드를 생성합니다',
+      params: {
+        collection: { type: 'string', description: '컬렉션/테이블 이름' },
+        data: { type: 'string', description: '레코드 데이터 (JSON 문자열)' },
+      },
+      handler: async ({ collection, data }) => {
+        const record = JSON.parse(data);
+        const id = `${collection}_${Date.now()}`;
+        await store.set(id, { ...record, _id: id, _collection: collection });
+        return { id, message: `${collection}에 생성 완료` };
+      },
+    }),
+
+    defineTool('read', {
+      description: '컬렉션에서 레코드를 조회합니다',
+      params: {
+        collection: { type: 'string', description: '컬렉션/테이블 이름' },
+        id: { type: 'string', description: '레코드 ID (생략하면 전체 조회)', optional: true },
+      },
+      handler: async ({ collection, id }) => {
+        if (id) {
+          const record = await store.get(id);
+          return record || { error: '찾을 수 없습니다' };
+        }
+        const all = await store.list({ prefix: `${collection}_` });
+        return { collection, count: all.length, records: all };
+      },
+    }),
+
+    defineTool('update', {
+      description: '기존 레코드를 수정합니다',
+      params: {
+        id: { type: 'string', description: '레코드 ID' },
+        data: { type: 'string', description: '수정할 필드 (JSON 문자열)' },
+      },
+      handler: async ({ id, data }) => {
+        const existing = await store.get(id);
+        if (!existing) return { error: '찾을 수 없습니다' };
+        const updated = { ...existing, ...JSON.parse(data) };
+        await store.set(id, updated);
+        return { id, message: '수정 완료', record: updated };
+      },
+    }),
+
+    defineTool('delete', {
+      description: '레코드를 삭제합니다',
+      params: {
+        id: { type: 'string', description: '레코드 ID' },
+      },
+      handler: async ({ id }) => {
+        const existing = await store.get(id);
+        if (!existing) return { error: '찾을 수 없습니다' };
+        await store.delete(id);
+        return { id, message: '삭제 완료' };
+      },
+    }),
+  ],
+});
+
+server.start();

package/dist/templates/crud-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"]
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { printer } from './printer.js';
+export { resolveClientConfig, listClients, resolveAirConfig } from './path-resolver.js';
+export type { SupportedClient, ClientPathInfo } from './path-resolver.js';
+export { JsonEditor } from './json-editor.js';
+export { ProcessManager } from './process-manager.js';
+export type { ServerProcess } from './process-manager.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACxF,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — utils/index.ts
+// re-export only. 로직 없음.
+export { printer } from './printer.js';
+export { resolveClientConfig, listClients, resolveAirConfig } from './path-resolver.js';
+export { JsonEditor } from './json-editor.js';
+export { ProcessManager } from './process-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,2BAA2B;AAC3B,yBAAyB;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}