@airmcp-dev/cli 0.1.0

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

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

@@ -0,0 +1,76 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-api-server — src/index.ts
+//
+// 외부 API 래핑 도구 서버 템플릿.
+// fetch로 외부 API를 호출하고 결과를 MCP 도구로 노출한다.
+// BASE_URL과 API_KEY를 환경변수로 설정.
+
+import { defineServer, defineTool } from '@airmcp-dev/core';
+
+const BASE_URL = process.env.API_BASE_URL || 'https://jsonplaceholder.typicode.com';
+const API_KEY = process.env.API_KEY || '';
+
+/** 공통 fetch 헬퍼 */
+async function apiFetch(path: string, options?: RequestInit): Promise<any> {
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+  };
+  if (API_KEY) headers['Authorization'] = `Bearer ${API_KEY}`;
+
+  const res = await fetch(`${BASE_URL}${path}`, { ...options, headers });
+  if (!res.ok) {
+    throw new Error(`API error: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+
+const server = defineServer({
+  name: 'my-api-server',
+  version: '0.1.0',
+
+  // transport: { type: 'sse', port: 3510 },
+  description: 'External API wrapper as MCP tools',
+
+  tools: [
+    defineTool('fetch', {
+      description: 'Fetch data from the API',
+      params: {
+        path: { type: 'string', description: 'API endpoint path (e.g. /users, /posts/1)' },
+      },
+      handler: async ({ path }) => {
+        const data = await apiFetch(path);
+        return data;
+      },
+    }),
+
+    defineTool('post', {
+      description: 'Create data via API',
+      params: {
+        path: { type: 'string', description: 'API endpoint path' },
+        body: { type: 'string', description: 'JSON string of request body' },
+      },
+      handler: async ({ path, body }) => {
+        const data = await apiFetch(path, {
+          method: 'POST',
+          body,
+        });
+        return data;
+      },
+    }),
+
+    defineTool('search', {
+      description: 'Search the API with query parameters',
+      params: {
+        path: { type: 'string', description: 'API endpoint path' },
+        query: { type: 'string', description: 'Query string (e.g. "q=hello&limit=10")' },
+      },
+      handler: async ({ path, query }) => {
+        const separator = path.includes('?') ? '&' : '?';
+        const data = await apiFetch(`${path}${separator}${query}`);
+        return data;
+      },
+    }),
+  ],
+});
+
+server.start();

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

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

@@ -0,0 +1,70 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-api-server — src/index.ts
+//
+// 외부 API 래핑 도구 서버 템플릿.
+// fetch로 외부 API를 호출하고 결과를 MCP 도구로 제공합니다.
+// BASE_URL과 API_KEY를 환경변수로 설정하세요.
+
+import { defineServer, defineTool } from '@airmcp-dev/core';
+
+const BASE_URL = process.env.API_BASE_URL || 'https://jsonplaceholder.typicode.com';
+const API_KEY = process.env.API_KEY || '';
+
+/** 공통 fetch 헬퍼 */
+async function apiFetch(path: string, options?: RequestInit): Promise<any> {
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+  };
+  if (API_KEY) headers['Authorization'] = `Bearer ${API_KEY}`;
+
+  const res = await fetch(`${BASE_URL}${path}`, { ...options, headers });
+  if (!res.ok) {
+    throw new Error(`API 오류: ${res.status} ${res.statusText}`);
+  }
+  return res.json();
+}
+
+const server = defineServer({
+  name: 'my-api-server',
+  version: '0.1.0',
+
+  // transport: { type: 'sse', port: 3510 },
+  description: '외부 API를 MCP 도구로 제공하는 서버',
+
+  tools: [
+    defineTool('fetch', {
+      description: 'API에서 데이터를 가져옵니다',
+      params: {
+        path: { type: 'string', description: 'API 경로 (예: /users, /posts/1)' },
+      },
+      handler: async ({ path }) => {
+        return await apiFetch(path);
+      },
+    }),
+
+    defineTool('post', {
+      description: 'API에 데이터를 생성합니다',
+      params: {
+        path: { type: 'string', description: 'API 경로' },
+        body: { type: 'string', description: '요청 본문 (JSON 문자열)' },
+      },
+      handler: async ({ path, body }) => {
+        return await apiFetch(path, { method: 'POST', body });
+      },
+    }),
+
+    defineTool('search', {
+      description: 'API를 검색합니다',
+      params: {
+        path: { type: 'string', description: 'API 경로' },
+        query: { type: 'string', description: '쿼리 문자열 (예: "q=hello&limit=10")' },
+      },
+      handler: async ({ path, query }) => {
+        const separator = path.includes('?') ? '&' : '?';
+        return await apiFetch(`${path}${separator}${query}`);
+      },
+    }),
+  ],
+});
+
+server.start();

package/dist/templates/api-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/templates/basic/.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