@airmcp-dev/cli 0.1.0

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

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

@@ -0,0 +1,39 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-mcp-server — src/index.ts
+//
+// MCP server template built with air.
+// defineServer + defineTool creates a ready-to-run MCP server.
+//
+// Transport options:
+//   type: 'stdio'  → Direct execution by Claude Desktop, etc. (default)
+//   type: 'sse'    → HTTP SSE server for remote connections
+//   type: 'http'   → Streamable HTTP server
+//
+// Change the port below if needed.
+
+import { defineServer, defineTool } from '@airmcp-dev/core';
+
+const server = defineServer({
+  name: 'my-mcp-server',
+  version: '0.1.0',
+  description: 'My first MCP server built with air',
+
+  // ── Transport ──
+  // Local: use 'stdio' (default, no config needed)
+  // Remote: change to 'sse' and set a port
+  // transport: { type: 'sse', port: 3510 },
+
+  tools: [
+    defineTool('hello', {
+      description: 'Say hello',
+      params: {
+        name: { type: 'string', description: 'Your name' },
+      },
+      handler: async ({ name }) => {
+        return `Hello, ${name}! 👋`;
+      },
+    }),
+  ],
+});
+
+server.start();

package/dist/templates/basic/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "@airmcp-dev/core/tsconfig.base",
+  "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-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/basic-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/basic-ko/package.json

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

@@ -0,0 +1,39 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// my-mcp-server — src/index.ts
+//
+// air 기반 MCP 서버 기본 템플릿.
+// defineServer + defineTool로 즉시 실행 가능한 MCP 서버를 만듭니다.
+//
+// transport 설정:
+//   type: 'stdio'  → Claude Desktop 등에서 직접 실행 (기본값)
+//   type: 'sse'    → HTTP SSE 서버로 실행 (리모트 연결)
+//   type: 'http'   → Streamable HTTP 서버로 실행
+//
+// 포트 변경은 아래 port 값을 수정하세요.
+
+import { defineServer, defineTool } from '@airmcp-dev/core';
+
+const server = defineServer({
+  name: 'my-mcp-server',
+  version: '0.1.0',
+  description: 'air로 만든 첫 번째 MCP 서버',
+
+  // ── Transport 설정 ──
+  // 로컬 사용: type을 'stdio'로 (기본값, 아래 주석 해제 불필요)
+  // 리모트 사용: type을 'sse'로 변경하고 port를 지정하세요
+  // transport: { type: 'sse', port: 3510 },
+
+  tools: [
+    defineTool('hello', {
+      description: '인사하기',
+      params: {
+        name: { type: 'string', description: '이름' },
+      },
+      handler: async ({ name }) => {
+        return `안녕하세요, ${name}님! 👋`;
+      },
+    }),
+  ],
+});
+
+server.start();

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