@objectstack/plugin-mcp-server 4.0.3 → 4.0.5

package/README.md

@@ -0,0 +1,528 @@
+# @objectstack/plugin-mcp-server
+
+MCP Runtime Server Plugin for ObjectStack — exposes AI tools, data resources, and agent prompts via the Model Context Protocol.
+
+## Features
+
+- **Model Context Protocol (MCP)**: Expose ObjectStack resources to AI models via MCP
+- **AI Tools**: Auto-generate MCP tools from ObjectStack actions and flows
+- **Data Resources**: Expose objects, records, and metadata as MCP resources
+- **Agent Prompts**: Register prompt templates for AI agents
+- **Type-Safe**: Full Zod schema validation for tool inputs/outputs
+- **Auto-Discovery**: MCP clients automatically discover available tools and resources
+- **Streaming Support**: Stream large datasets and real-time updates
+- **Security**: Built-in permission checks for tool execution
+
+## What is MCP?
+
+Model Context Protocol (MCP) is an open protocol that standardizes how AI applications provide context to Large Language Models (LLMs). It allows AI models to:
+
+- **Access Tools**: Execute functions and operations
+- **Read Resources**: Access data and content
+- **Use Prompts**: Leverage pre-defined prompt templates
+
+Read more: [MCP Specification](https://modelcontextprotocol.io/)
+
+## Installation
+
+```bash
+pnpm add @objectstack/plugin-mcp-server
+```
+
+## Basic Usage
+
+```typescript
+import { defineStack } from '@objectstack/spec';
+import { PluginMCPServer } from '@objectstack/plugin-mcp-server';
+
+const stack = defineStack({
+  plugins: [
+    PluginMCPServer.configure({
+      serverName: 'objectstack-server',
+      version: '1.0.0',
+      autoRegisterTools: true,
+    }),
+  ],
+});
+```
+
+## Configuration
+
+```typescript
+interface MCPServerConfig {
+  /** Server name (shown to AI clients) */
+  serverName?: string;
+
+  /** Server version */
+  version?: string;
+
+  /** Auto-register tools from actions and flows */
+  autoRegisterTools?: boolean;
+
+  /** Auto-expose objects as resources */
+  autoExposeObjects?: boolean;
+
+  /** Enable streaming for large responses */
+  enableStreaming?: boolean;
+
+  /** Transport mechanism ('stdio' | 'http') */
+  transport?: 'stdio' | 'http';
+
+  /** HTTP port (if transport is 'http') */
+  port?: number;
+}
+```
+
+## MCP Tools
+
+### Auto-Generated Tools
+
+ObjectStack automatically exposes these operations as MCP tools:
+
+```typescript
+// CRUD operations (auto-registered)
+'objectstack_find'         // Query records
+'objectstack_findOne'      // Get single record
+'objectstack_create'       // Create record
+'objectstack_update'       // Update record
+'objectstack_delete'       // Delete record
+
+// Metadata operations
+'objectstack_describeObject'   // Get object schema
+'objectstack_listObjects'      // List all objects
+'objectstack_listFields'       // List object fields
+```
+
+### Custom Tools
+
+Register custom tools that AI models can call:
+
+```typescript
+import { defineTool } from '@objectstack/spec';
+
+const calculateRevenueTool = defineTool({
+  name: 'calculate_revenue',
+  description: 'Calculate total revenue for an account',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      accountId: { type: 'string', description: 'Account ID' },
+      startDate: { type: 'string', description: 'Start date (ISO 8601)' },
+      endDate: { type: 'string', description: 'End date (ISO 8601)' },
+    },
+    required: ['accountId'],
+  },
+  async execute({ accountId, startDate, endDate }) {
+    const opportunities = await kernel.getDriver().find({
+      object: 'opportunity',
+      filters: [
+        { field: 'account_id', operator: 'eq', value: accountId },
+        { field: 'stage', operator: 'eq', value: 'closed_won' },
+        { field: 'close_date', operator: 'gte', value: startDate },
+        { field: 'close_date', operator: 'lte', value: endDate },
+      ],
+    });
+
+    const total = opportunities.reduce((sum, opp) => sum + opp.amount, 0);
+
+    return {
+      accountId,
+      totalRevenue: total,
+      opportunityCount: opportunities.length,
+    };
+  },
+});
+
+// Register with MCP server
+kernel.getService('mcp').registerTool(calculateRevenueTool);
+```
+
+## MCP Resources
+
+### Auto-Exposed Objects
+
+All ObjectStack objects are automatically exposed as MCP resources:
+
+```
+objectstack://objects/opportunity           # Opportunity object schema
+objectstack://objects/opportunity/records   # All opportunity records
+objectstack://objects/opportunity/123       # Specific opportunity record
+```
+
+### Custom Resources
+
+Expose custom resources to AI models:
+
+```typescript
+kernel.getService('mcp').registerResource({
+  uri: 'objectstack://reports/sales-pipeline',
+  name: 'Sales Pipeline Report',
+  description: 'Current sales pipeline with stages and amounts',
+  mimeType: 'application/json',
+  async read() {
+    const opportunities = await kernel.getDriver().find({
+      object: 'opportunity',
+      filters: [
+        { field: 'stage', operator: 'neq', value: 'closed_won' },
+        { field: 'stage', operator: 'neq', value: 'closed_lost' },
+      ],
+    });
+
+    const pipeline = opportunities.reduce((acc, opp) => {
+      acc[opp.stage] = (acc[opp.stage] || 0) + opp.amount;
+      return acc;
+    }, {});
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(pipeline, null, 2),
+        },
+      ],
+    };
+  },
+});
+```
+
+## MCP Prompts
+
+Register prompt templates that AI models can use:
+
+```typescript
+kernel.getService('mcp').registerPrompt({
+  name: 'analyze_account',
+  description: 'Analyze an account and its opportunities',
+  arguments: [
+    {
+      name: 'accountId',
+      description: 'Account ID to analyze',
+      required: true,
+    },
+  ],
+  async render({ accountId }) {
+    const account = await kernel.getDriver().findOne({
+      object: 'account',
+      filters: [{ field: 'id', operator: 'eq', value: accountId }],
+    });
+
+    const opportunities = await kernel.getDriver().find({
+      object: 'opportunity',
+      filters: [{ field: 'account_id', operator: 'eq', value: accountId }],
+    });
+
+    return {
+      messages: [
+        {
+          role: 'user',
+          content: {
+            type: 'text',
+            text: `Analyze this account and provide insights:
+
+Account: ${account.name}
+Industry: ${account.industry}
+Total Opportunities: ${opportunities.length}
+Total Value: $${opportunities.reduce((sum, o) => sum + o.amount, 0)}
+
+Opportunities:
+${opportunities.map(o => `- ${o.name} (${o.stage}): $${o.amount}`).join('\n')}
+
+Please provide:
+1. Key insights about this account
+2. Risk assessment
+3. Recommendations for next steps`,
+          },
+        },
+      ],
+    };
+  },
+});
+```
+
+## Using with AI Clients
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "objectstack": {
+      "command": "node",
+      "args": ["/path/to/your/objectstack/server.js"],
+      "env": {
+        "DATABASE_URL": "your-database-url"
+      }
+    }
+  }
+}
+```
+
+### Cursor IDE
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "objectstack": {
+      "command": "node",
+      "args": ["./server.js"]
+    }
+  }
+}
+```
+
+### Cline VS Code Extension
+
+Configure in Cline settings:
+
+```json
+{
+  "cline.mcpServers": {
+    "objectstack": {
+      "command": "node",
+      "args": ["./server.js"]
+    }
+  }
+}
+```
+
+## Server Implementation
+
+### Stdio Transport (Default)
+
+```typescript
+// server.ts
+import { defineStack } from '@objectstack/spec';
+import { PluginMCPServer } from '@objectstack/plugin-mcp-server';
+import { DriverTurso } from '@objectstack/driver-turso';
+
+const stack = defineStack({
+  driver: DriverTurso.configure({
+    url: process.env.DATABASE_URL!,
+    authToken: process.env.TURSO_AUTH_TOKEN!,
+  }),
+  plugins: [
+    PluginMCPServer.configure({
+      serverName: 'my-crm',
+      transport: 'stdio', // Claude Desktop, Cursor, Cline
+    }),
+  ],
+});
+
+await stack.boot();
+```
+
+### HTTP Transport
+
+```typescript
+const stack = defineStack({
+  driver: DriverTurso.configure({ /* ... */ }),
+  plugins: [
+    PluginMCPServer.configure({
+      serverName: 'my-crm',
+      transport: 'http',
+      port: 3100,
+    }),
+  ],
+});
+
+await stack.boot();
+// MCP server running on http://localhost:3100
+```
+
+## Advanced Features
+
+### Streaming Resources
+
+```typescript
+kernel.getService('mcp').registerResource({
+  uri: 'objectstack://exports/opportunities-csv',
+  name: 'Opportunities Export (CSV)',
+  mimeType: 'text/csv',
+  async *stream() {
+    // Stream header
+    yield 'Name,Stage,Amount,Close Date\n';
+
+    // Stream records in batches
+    let offset = 0;
+    const batchSize = 100;
+
+    while (true) {
+      const batch = await kernel.getDriver().find({
+        object: 'opportunity',
+        limit: batchSize,
+        offset,
+      });
+
+      if (batch.length === 0) break;
+
+      for (const opp of batch) {
+        yield `${opp.name},${opp.stage},${opp.amount},${opp.close_date}\n`;
+      }
+
+      offset += batchSize;
+    }
+  },
+});
+```
+
+### Tool Permissions
+
+```typescript
+kernel.getService('mcp').registerTool({
+  name: 'delete_opportunity',
+  description: 'Delete an opportunity',
+  permissions: ['opportunity:delete'], // Require permission
+  inputSchema: {
+    type: 'object',
+    properties: {
+      id: { type: 'string' },
+    },
+    required: ['id'],
+  },
+  async execute({ id }, context) {
+    // context includes userId, permissions, etc.
+    if (!context.hasPermission('opportunity:delete')) {
+      throw new Error('Permission denied');
+    }
+
+    await kernel.getDriver().delete({
+      object: 'opportunity',
+      filters: [{ field: 'id', operator: 'eq', value: id }],
+    });
+
+    return { success: true, deleted: id };
+  },
+});
+```
+
+### Dynamic Tool Registration
+
+```typescript
+// Register tools from flow definitions
+const flows = await kernel.getMetadata('flow');
+
+for (const flow of flows) {
+  kernel.getService('mcp').registerTool({
+    name: `flow_${flow.name}`,
+    description: flow.description,
+    inputSchema: generateSchemaFromFlow(flow),
+    async execute(inputs) {
+      return await kernel.executeFlow(flow.name, inputs);
+    },
+  });
+}
+```
+
+## Server Capabilities
+
+The MCP server exposes these capabilities:
+
+```json
+{
+  "capabilities": {
+    "tools": {
+      "listChanged": true
+    },
+    "resources": {
+      "subscribe": true,
+      "listChanged": true
+    },
+    "prompts": {
+      "listChanged": true
+    },
+    "logging": {},
+    "experimental": {
+      "streaming": true
+    }
+  }
+}
+```
+
+## Best Practices
+
+1. **Tool Design**: Keep tools focused and well-documented
+2. **Resource Naming**: Use clear, hierarchical URI schemes
+3. **Prompt Templates**: Make prompts flexible with arguments
+4. **Error Handling**: Always return helpful error messages
+5. **Permissions**: Check permissions before tool execution
+6. **Performance**: Use streaming for large datasets
+7. **Versioning**: Version your server and tools
+
+## Debugging
+
+Enable debug logging:
+
+```typescript
+PluginMCPServer.configure({
+  serverName: 'my-crm',
+  debug: true, // Log all MCP messages
+});
+```
+
+View MCP messages in client:
+- **Claude Desktop**: Check logs in `~/Library/Logs/Claude/mcp*.log`
+- **Cursor**: Check Output panel → MCP Server
+- **Cline**: Check extension logs
+
+## Example: Complete CRM Server
+
+```typescript
+import { defineStack, defineTool } from '@objectstack/spec';
+import { PluginMCPServer } from '@objectstack/plugin-mcp-server';
+
+const stack = defineStack({
+  driver: /* ... */,
+  plugins: [
+    PluginMCPServer.configure({
+      serverName: 'crm-assistant',
+      autoRegisterTools: true,
+    }),
+  ],
+});
+
+await stack.boot();
+
+const mcp = stack.kernel.getService('mcp');
+
+// Register custom tools
+mcp.registerTool(defineTool({
+  name: 'forecast_revenue',
+  description: 'Forecast revenue based on pipeline',
+  async execute() {
+    // Implementation
+  },
+}));
+
+// Register custom resources
+mcp.registerResource({
+  uri: 'objectstack://dashboards/sales',
+  name: 'Sales Dashboard',
+  async read() {
+    // Implementation
+  },
+});
+
+// Register prompts
+mcp.registerPrompt({
+  name: 'weekly_report',
+  description: 'Generate weekly sales report',
+  async render() {
+    // Implementation
+  },
+});
+```
+
+## License
+
+Apache-2.0
+
+## See Also
+
+- [Model Context Protocol Specification](https://modelcontextprotocol.io/)
+- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
+- [@objectstack/spec/ai](../../spec/src/ai/)
+- [Building MCP Servers Guide](/content/docs/guides/mcp/)

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/mcp-server-runtime.ts","../src/plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * @objectstack/plugin-mcp-server\n *\n * MCP Runtime Server Plugin for ObjectStack.\n * Exposes all registered AI tools, data resources, and agent prompts\n * via the Model Context Protocol (MCP) for use by external AI clients\n * (Claude Desktop, Cursor, VS Code Copilot, etc.).\n */\n\nexport { MCPServerPlugin } from './plugin.js';\nexport type { MCPServerPluginOptions } from './plugin.js';\nexport { MCPServerRuntime } from './mcp-server-runtime.js';\nexport type { MCPServerRuntimeConfig } from './mcp-server-runtime.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport type { Logger, IMetadataService, IDataEngine, AIToolDefinition } from '@objectstack/spec/contracts';\nimport type { Agent } from '@objectstack/spec';\nimport type { ToolRegistry, ToolExecutionResult } from './types.js';\nimport { z } from 'zod';\n\n/**\n * Configuration for the MCP Server Runtime.\n */\nexport interface MCPServerRuntimeConfig {\n  /** Human-readable server name. */\n  name?: string;\n  /** Server version (semver). */\n  version?: string;\n  /** Optional instructions describing how to use the server. */\n  instructions?: string;\n  /** Transport mode: 'stdio' (default) or 'http'. */\n  transport?: 'stdio' | 'http';\n  /** Logger instance. */\n  logger?: Logger;\n}\n\n/**\n * Minimal shape of an object definition returned by IMetadataService.\n */\ninterface ObjectDef {\n  name: string;\n  label?: string;\n  fields?: Record<string, { name?: string; type?: string; label?: string; required?: boolean }>;\n  enable?: Record<string, boolean>;\n}\n\n/**\n * Names of tools that are read-only (no side effects).\n * Kept as a module-level constant for easy extension.\n */\nconst READ_ONLY_TOOLS = new Set([\n  'list_objects',\n  'describe_object',\n  'query_records',\n  'get_record',\n  'aggregate_data',\n]);\n\n/**\n * Names of tools that perform destructive mutations.\n */\nconst DESTRUCTIVE_TOOLS = new Set([\n  'delete_field',\n]);\n\n/**\n * MCPServerRuntime — Bridges ObjectStack kernel services to the Model Context Protocol.\n *\n * Responsibilities:\n * 1. Bridge ToolRegistry → MCP tools (all registered AI tools)\n * 2. Bridge IMetadataService → MCP resources (object schemas, metadata types)\n * 3. Bridge IDataEngine → MCP resources (record access by URI)\n * 4. Bridge Agent definitions → MCP prompts (agent instructions)\n *\n * Architecture:\n * ```\n * ToolRegistry (service-ai)  ──┐\n * IMetadataService (metadata) ─┼──→  MCPServerRuntime  ──→  McpServer (SDK)\n * IDataEngine (objectql)     ──┤                              │\n * Agent definitions          ──┘                              ├── stdio transport\n *                                                             └── http transport (future)\n * ```\n */\nexport class MCPServerRuntime {\n  private readonly mcpServer: McpServer;\n  private readonly config: Required<Pick<MCPServerRuntimeConfig, 'name' | 'version'>> & MCPServerRuntimeConfig;\n  private transport: StdioServerTransport | undefined;\n  private started = false;\n\n  constructor(config: MCPServerRuntimeConfig = {}) {\n    this.config = {\n      name: 'objectstack',\n      version: '1.0.0',\n      transport: 'stdio',\n      ...config,\n    };\n\n    this.mcpServer = new McpServer(\n      {\n        name: this.config.name,\n        version: this.config.version,\n      },\n      {\n        capabilities: {\n          resources: {},\n          tools: {},\n          prompts: {},\n          logging: {},\n        },\n        instructions: this.config.instructions ?? 'ObjectStack MCP Server — access data objects, AI tools, and agent prompts.',\n      },\n    );\n  }\n\n  /** The underlying McpServer instance (for advanced use cases). */\n  get server(): McpServer {\n    return this.mcpServer;\n  }\n\n  /** Whether the server is currently connected and running. */\n  get isStarted(): boolean {\n    return this.started;\n  }\n\n  // ── Helpers ─────────────────────────────────────────────────────\n\n  /**\n   * Extract the text value from a ToolExecutionResult's output.\n   *\n   * The output may be a `{ type: 'text', value: string }` object (from the\n   * Vercel AI SDK ToolResultPart) or any serialisable value.\n   */\n  private static formatToolOutput(result: ToolExecutionResult): string {\n    const output = result.output;\n    if (output && typeof output === 'object' && 'value' in output) {\n      return String((output as { value: unknown }).value);\n    }\n    return JSON.stringify(output ?? '');\n  }\n\n  // ── Tool Bridge ────────────────────────────────────────────────\n\n  /**\n   * Bridge all tools from the ToolRegistry to MCP tools.\n   *\n   * Each registered tool becomes an MCP tool with the same name, description,\n   * and JSON Schema parameters. The handler delegates to the ToolRegistry's\n   * execute path.\n   */\n  bridgeTools(toolRegistry: ToolRegistry): void {\n    const tools = toolRegistry.getAll();\n    const logger = this.config.logger;\n\n    for (const tool of tools) {\n      this.registerToolFromDefinition(tool, toolRegistry);\n    }\n\n    logger?.info(`[MCP] Bridged ${tools.length} tools from ToolRegistry`);\n  }\n\n  /**\n   * Register a single tool on the MCP server from an AIToolDefinition.\n   */\n  private registerToolFromDefinition(tool: AIToolDefinition, toolRegistry: ToolRegistry): void {\n    const logger = this.config.logger;\n\n    // Convert JSON Schema parameters to Zod-compatible format for MCP SDK\n    // The MCP SDK registerTool with inputSchema expects a Zod raw shape or AnySchema.\n    // Since our tools use JSON Schema, we use the low-level .tool() with a raw callback\n    // and pass the JSON Schema as annotations metadata.\n    this.mcpServer.registerTool(\n      tool.name,\n      {\n        description: tool.description,\n        annotations: {\n          // Mark tools with write side-effects for destructive operations\n          destructiveHint: this.isDestructiveTool(tool.name),\n          readOnlyHint: this.isReadOnlyTool(tool.name),\n          openWorldHint: false,\n        },\n      },\n      async (extra) => {\n        // The MCP SDK passes tool arguments via the extra.arguments property\n        // when registerTool is called without an inputSchema.\n        const rawExtra = extra as Record<string, unknown>;\n        const args = (rawExtra.arguments ?? {}) as Record<string, unknown>;\n\n        try {\n          const result = await toolRegistry.execute({\n            type: 'tool-call',\n            toolCallId: `mcp-${tool.name}-${Date.now()}`,\n            toolName: tool.name,\n            input: args,\n          });\n\n          const outputText = MCPServerRuntime.formatToolOutput(result);\n\n          if (result.isError) {\n            return {\n              content: [{ type: 'text' as const, text: outputText }],\n              isError: true,\n            };\n          }\n\n          return {\n            content: [{ type: 'text' as const, text: outputText }],\n          };\n        } catch (err) {\n          const message = err instanceof Error ? err.message : String(err);\n          logger?.warn(`[MCP] Tool \"${tool.name}\" execution failed:`, { error: message });\n          return {\n            content: [{ type: 'text' as const, text: message }],\n            isError: true,\n          };\n        }\n      },\n    );\n  }\n\n  /**\n   * Check if a tool is read-only (data query tools).\n   */\n  private isReadOnlyTool(name: string): boolean {\n    return READ_ONLY_TOOLS.has(name);\n  }\n\n  /**\n   * Check if a tool performs destructive operations.\n   */\n  private isDestructiveTool(name: string): boolean {\n    return DESTRUCTIVE_TOOLS.has(name);\n  }\n\n  // ── Resource Bridge ────────────────────────────────────────────\n\n  /**\n   * Bridge metadata service and data engine to MCP resources.\n   *\n   * Exposes:\n   * - `objectstack://objects` — List all data objects\n   * - `objectstack://objects/{objectName}` — Get object schema\n   * - `objectstack://objects/{objectName}/records/{recordId}` — Get a specific record\n   * - `objectstack://metadata/types` — List all metadata types\n   */\n  bridgeResources(metadataService: IMetadataService, dataEngine?: IDataEngine): void {\n    const logger = this.config.logger;\n    let resourceCount = 0;\n\n    // ── Static resource: List all objects ──\n    this.mcpServer.registerResource(\n      'object_list',\n      'objectstack://objects',\n      {\n        description: 'List all data objects (tables) in the ObjectStack instance',\n        mimeType: 'application/json',\n      },\n      async () => {\n        const objects = await metadataService.listObjects();\n        const summary = (objects as ObjectDef[]).map(o => ({\n          name: o.name,\n          label: o.label ?? o.name,\n          fieldCount: o.fields ? Object.keys(o.fields).length : 0,\n        }));\n\n        return {\n          contents: [{\n            uri: 'objectstack://objects',\n            mimeType: 'application/json',\n            text: JSON.stringify({ objects: summary, totalCount: summary.length }, null, 2),\n          }],\n        };\n      },\n    );\n    resourceCount++;\n\n    // ── Template resource: Object schema ──\n    this.mcpServer.registerResource(\n      'object_schema',\n      new ResourceTemplate('objectstack://objects/{objectName}', { list: undefined }),\n      {\n        description: 'Get the full schema of a specific data object including fields and features',\n        mimeType: 'application/json',\n      },\n      async (_uri, variables) => {\n        const objectName = String(variables.objectName);\n        const objectDef = await metadataService.getObject(objectName);\n\n        if (!objectDef) {\n          return {\n            contents: [{\n              uri: `objectstack://objects/${objectName}`,\n              mimeType: 'application/json',\n              text: JSON.stringify({ error: `Object \"${objectName}\" not found` }),\n            }],\n          };\n        }\n\n        const def = objectDef as ObjectDef;\n        const fields = def.fields ?? {};\n        const fieldSummary = Object.entries(fields).map(([key, f]) => ({\n          name: key,\n          type: f.type,\n          label: f.label ?? key,\n          required: f.required ?? false,\n        }));\n\n        return {\n          contents: [{\n            uri: `objectstack://objects/${objectName}`,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              name: def.name,\n              label: def.label ?? def.name,\n              fields: fieldSummary,\n              enableFeatures: def.enable ?? {},\n            }, null, 2),\n          }],\n        };\n      },\n    );\n    resourceCount++;\n\n    // ── Template resource: Record by ID ──\n    if (dataEngine) {\n      this.mcpServer.registerResource(\n        'record_by_id',\n        new ResourceTemplate('objectstack://objects/{objectName}/records/{recordId}', { list: undefined }),\n        {\n          description: 'Get a specific record by ID from a data object',\n          mimeType: 'application/json',\n        },\n        async (_uri, variables) => {\n          const objectName = String(variables.objectName);\n          const recordId = String(variables.recordId);\n\n          try {\n            const record = await dataEngine.findOne(objectName, {\n              where: { id: recordId },\n            });\n\n            if (!record) {\n              return {\n                contents: [{\n                  uri: `objectstack://objects/${objectName}/records/${recordId}`,\n                  mimeType: 'application/json',\n                  text: JSON.stringify({ error: `Record \"${recordId}\" not found in \"${objectName}\"` }),\n                }],\n              };\n            }\n\n            return {\n              contents: [{\n                uri: `objectstack://objects/${objectName}/records/${recordId}`,\n                mimeType: 'application/json',\n                text: JSON.stringify(record, null, 2),\n              }],\n            };\n          } catch (err) {\n            const message = err instanceof Error ? err.message : String(err);\n            return {\n              contents: [{\n                uri: `objectstack://objects/${objectName}/records/${recordId}`,\n                mimeType: 'application/json',\n                text: JSON.stringify({ error: message }),\n              }],\n            };\n          }\n        },\n      );\n      resourceCount++;\n    }\n\n    // ── Static resource: Metadata types ──\n    if (metadataService.getRegisteredTypes) {\n      this.mcpServer.registerResource(\n        'metadata_types',\n        'objectstack://metadata/types',\n        {\n          description: 'List all registered metadata types (object, app, view, agent, tool, etc.)',\n          mimeType: 'application/json',\n        },\n        async () => {\n          const types = await metadataService.getRegisteredTypes!();\n          return {\n            contents: [{\n              uri: 'objectstack://metadata/types',\n              mimeType: 'application/json',\n              text: JSON.stringify({ types, totalCount: types.length }, null, 2),\n            }],\n          };\n        },\n      );\n      resourceCount++;\n    }\n\n    logger?.info(`[MCP] Bridged ${resourceCount} resource endpoints`);\n  }\n\n  // ── Prompt Bridge ──────────────────────────────────────────────\n\n  /**\n   * Bridge registered agents to MCP prompts.\n   *\n   * Each active agent becomes an MCP prompt with:\n   * - Name matching the agent name\n   * - System message from agent instructions\n   * - Optional context arguments (objectName, recordId, viewName)\n   */\n  bridgePrompts(metadataService: IMetadataService): void {\n    const logger = this.config.logger;\n\n    // Register a dynamic prompt that loads agents at call time\n    this.mcpServer.registerPrompt(\n      'agent_prompt',\n      {\n        description: 'Load an agent\\'s system prompt with optional UI context. ' +\n          'Use the agentName argument to select which agent\\'s instructions to use.',\n        argsSchema: {\n          agentName: z.string().describe('Name of the agent to load (e.g. \"data_chat\", \"metadata_assistant\")'),\n          objectName: z.string().optional().describe('Current object the user is viewing'),\n          recordId: z.string().optional().describe('Currently selected record ID'),\n          viewName: z.string().optional().describe('Current view name'),\n        },\n      },\n      async (args) => {\n        const agentName = String(args.agentName ?? '');\n        if (!agentName) {\n          return {\n            messages: [{\n              role: 'user' as const,\n              content: { type: 'text' as const, text: 'Error: agentName argument is required' },\n            }],\n          };\n        }\n\n        const raw = await metadataService.get('agent', agentName);\n        if (!raw) {\n          return {\n            messages: [{\n              role: 'user' as const,\n              content: { type: 'text' as const, text: `Error: Agent \"${agentName}\" not found` },\n            }],\n          };\n        }\n\n        const agent = raw as Agent;\n\n        // Build system prompt from agent instructions + context\n        const parts: string[] = [];\n        parts.push(agent.instructions ?? '');\n\n        const contextHints: string[] = [];\n        if (args.objectName) contextHints.push(`Current object: ${args.objectName}`);\n        if (args.recordId) contextHints.push(`Selected record ID: ${args.recordId}`);\n        if (args.viewName) contextHints.push(`Current view: ${args.viewName}`);\n        if (contextHints.length > 0) {\n          parts.push('\\n--- Current Context ---\\n' + contextHints.join('\\n'));\n        }\n\n        return {\n          messages: [{\n            role: 'assistant' as const,\n            content: { type: 'text' as const, text: parts.join('\\n') },\n          }],\n        };\n      },\n    );\n\n    logger?.info('[MCP] Agent prompts bridged');\n  }\n\n  // ── Lifecycle ──────────────────────────────────────────────────\n\n  /**\n   * Start the MCP server with the configured transport.\n   *\n   * For stdio transport, this connects to process stdin/stdout.\n   */\n  async start(): Promise<void> {\n    if (this.started) return;\n\n    const logger = this.config.logger;\n\n    if (this.config.transport === 'stdio') {\n      this.transport = new StdioServerTransport();\n      await this.mcpServer.connect(this.transport);\n      this.started = true;\n      logger?.info(`[MCP] Server started (transport: stdio, name: ${this.config.name})`);\n    } else {\n      // HTTP transport support will be added in a future version\n      logger?.warn('[MCP] HTTP transport is not yet supported. Use stdio transport.');\n    }\n  }\n\n  /**\n   * Stop the MCP server and disconnect the transport.\n   */\n  async stop(): Promise<void> {\n    if (!this.started) return;\n\n    await this.mcpServer.close();\n    this.transport = undefined;\n    this.started = false;\n    this.config.logger?.info('[MCP] Server stopped');\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IAIService, IDataEngine, IMetadataService } from '@objectstack/spec/contracts';\nimport { MCPServerRuntime } from './mcp-server-runtime.js';\nimport type { MCPServerRuntimeConfig } from './mcp-server-runtime.js';\nimport type { ToolRegistry } from './types.js';\n\n/**\n * Configuration options for the MCPServerPlugin.\n */\nexport interface MCPServerPluginOptions {\n  /** Override MCP server name. Defaults to 'objectstack'. */\n  name?: string;\n  /** Override MCP server version. Defaults to package version. */\n  version?: string;\n  /** Transport mode: 'stdio' (default). */\n  transport?: 'stdio' | 'http';\n  /** Whether to auto-start the MCP server. Defaults to false (manual start via env var). */\n  autoStart?: boolean;\n  /** Custom instructions for the MCP server. */\n  instructions?: string;\n}\n\n/**\n * MCPServerPlugin — Kernel plugin that exposes ObjectStack as an MCP server.\n *\n * Lifecycle:\n * 1. **init** — Creates {@link MCPServerRuntime} and registers as `'mcp'` service.\n * 2. **start** — Bridges ToolRegistry, MetadataService, DataEngine, and Agents\n *    to the MCP server. Starts the transport if `autoStart` is enabled or\n *    the `MCP_SERVER_ENABLED` environment variable is set.\n * 3. **destroy** — Stops the MCP transport.\n *\n * Environment Variables:\n * - `MCP_SERVER_ENABLED=true` — Enable MCP server at startup\n * - `MCP_SERVER_NAME` — Override server name\n * - `MCP_SERVER_TRANSPORT` — Override transport ('stdio' | 'http')\n *\n * @example\n * ```ts\n * import { LiteKernel } from '@objectstack/core';\n * import { MCPServerPlugin } from '@objectstack/plugin-mcp-server';\n *\n * const kernel = new LiteKernel();\n * kernel.use(new MCPServerPlugin({ autoStart: true }));\n * await kernel.bootstrap();\n * ```\n */\nexport class MCPServerPlugin implements Plugin {\n  name = 'com.objectstack.plugin-mcp-server';\n  version = '1.0.0';\n  type = 'standard' as const;\n  dependencies: string[] = [];\n\n  private runtime?: MCPServerRuntime;\n  private readonly options: MCPServerPluginOptions;\n\n  constructor(options: MCPServerPluginOptions = {}) {\n    this.options = options;\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const config: MCPServerRuntimeConfig = {\n      name: process.env.MCP_SERVER_NAME ?? this.options.name ?? 'objectstack',\n      version: this.options.version ?? '1.0.0',\n      transport: (process.env.MCP_SERVER_TRANSPORT as 'stdio' | 'http') ?? this.options.transport ?? 'stdio',\n      instructions: this.options.instructions,\n      logger: ctx.logger,\n    };\n\n    this.runtime = new MCPServerRuntime(config);\n    ctx.registerService('mcp', this.runtime);\n\n    ctx.logger.info('[MCP] Plugin initialized');\n  }\n\n  async start(ctx: PluginContext): Promise<void> {\n    if (!this.runtime) return;\n\n    // ── Bridge tools from AIService ──\n    // The IAIService contract does not formally include `toolRegistry` because\n    // it is an implementation detail of AIService.  We use duck-typing here to\n    // avoid a hard dependency on @objectstack/service-ai while still bridging\n    // tools when the full AIService implementation is present.\n    try {\n      const aiService = ctx.getService<IAIService & { toolRegistry?: ToolRegistry }>('ai');\n      if (aiService?.toolRegistry) {\n        this.runtime.bridgeTools(aiService.toolRegistry);\n      } else {\n        ctx.logger.debug('[MCP] AI service does not expose a toolRegistry, skipping tool bridging');\n      }\n    } catch {\n      ctx.logger.debug('[MCP] AI service not available, skipping tool bridging');\n    }\n\n    // ── Bridge resources from MetadataService & DataEngine ──\n    let metadataService: IMetadataService | undefined;\n    let dataEngine: IDataEngine | undefined;\n\n    try {\n      metadataService = ctx.getService<IMetadataService>('metadata');\n    } catch {\n      ctx.logger.debug('[MCP] Metadata service not available, skipping resource bridging');\n    }\n\n    try {\n      dataEngine = ctx.getService<IDataEngine>('data');\n    } catch {\n      ctx.logger.debug('[MCP] Data engine not available, skipping record resources');\n    }\n\n    if (metadataService) {\n      this.runtime.bridgeResources(metadataService, dataEngine);\n      this.runtime.bridgePrompts(metadataService);\n    }\n\n    // ── Auto-start if configured ──\n    const shouldStart = this.options.autoStart || process.env.MCP_SERVER_ENABLED === 'true';\n    if (shouldStart) {\n      await this.runtime.start();\n      ctx.logger.info('[MCP] Server started automatically');\n    } else {\n      ctx.logger.info(\n        '[MCP] Server ready but not started. Set MCP_SERVER_ENABLED=true or use autoStart option.',\n      );\n    }\n\n    // Trigger hook for other plugins to extend MCP\n    await ctx.trigger('mcp:ready', this.runtime);\n  }\n\n  async destroy(): Promise<void> {\n    if (this.runtime?.isStarted) {\n      await this.runtime.stop();\n    }\n    this.runtime = undefined;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/mcp-server-runtime.ts","../src/plugin.ts"],"sourcesContent":["// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\n/**\n * @objectstack/plugin-mcp-server\n *\n * MCP Runtime Server Plugin for ObjectStack.\n * Exposes all registered AI tools, data resources, and agent prompts\n * via the Model Context Protocol (MCP) for use by external AI clients\n * (Claude Desktop, Cursor, VS Code Copilot, etc.).\n */\n\nexport { MCPServerPlugin } from './plugin.js';\nexport type { MCPServerPluginOptions } from './plugin.js';\nexport { MCPServerRuntime } from './mcp-server-runtime.js';\nexport type { MCPServerRuntimeConfig } from './mcp-server-runtime.js';\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport type { Logger, IMetadataService, IDataEngine, AIToolDefinition } from '@objectstack/spec/contracts';\nimport type { Agent } from '@objectstack/spec/ai';\nimport type { ToolRegistry, ToolExecutionResult } from './types.js';\nimport { z } from 'zod';\n\n/**\n * Configuration for the MCP Server Runtime.\n */\nexport interface MCPServerRuntimeConfig {\n  /** Human-readable server name. */\n  name?: string;\n  /** Server version (semver). */\n  version?: string;\n  /** Optional instructions describing how to use the server. */\n  instructions?: string;\n  /** Transport mode: 'stdio' (default) or 'http'. */\n  transport?: 'stdio' | 'http';\n  /** Logger instance. */\n  logger?: Logger;\n}\n\n/**\n * Minimal shape of an object definition returned by IMetadataService.\n */\ninterface ObjectDef {\n  name: string;\n  label?: string;\n  fields?: Record<string, { name?: string; type?: string; label?: string; required?: boolean }>;\n  enable?: Record<string, boolean>;\n}\n\n/**\n * Names of tools that are read-only (no side effects).\n * Kept as a module-level constant for easy extension.\n */\nconst READ_ONLY_TOOLS = new Set([\n  'list_objects',\n  'describe_object',\n  'query_records',\n  'get_record',\n  'aggregate_data',\n]);\n\n/**\n * Names of tools that perform destructive mutations.\n */\nconst DESTRUCTIVE_TOOLS = new Set([\n  'delete_field',\n]);\n\n/**\n * MCPServerRuntime — Bridges ObjectStack kernel services to the Model Context Protocol.\n *\n * Responsibilities:\n * 1. Bridge ToolRegistry → MCP tools (all registered AI tools)\n * 2. Bridge IMetadataService → MCP resources (object schemas, metadata types)\n * 3. Bridge IDataEngine → MCP resources (record access by URI)\n * 4. Bridge Agent definitions → MCP prompts (agent instructions)\n *\n * Architecture:\n * ```\n * ToolRegistry (service-ai)  ──┐\n * IMetadataService (metadata) ─┼──→  MCPServerRuntime  ──→  McpServer (SDK)\n * IDataEngine (objectql)     ──┤                              │\n * Agent definitions          ──┘                              ├── stdio transport\n *                                                             └── http transport (future)\n * ```\n */\nexport class MCPServerRuntime {\n  private readonly mcpServer: McpServer;\n  private readonly config: Required<Pick<MCPServerRuntimeConfig, 'name' | 'version'>> & MCPServerRuntimeConfig;\n  private transport: StdioServerTransport | undefined;\n  private started = false;\n\n  constructor(config: MCPServerRuntimeConfig = {}) {\n    this.config = {\n      name: 'objectstack',\n      version: '1.0.0',\n      transport: 'stdio',\n      ...config,\n    };\n\n    this.mcpServer = new McpServer(\n      {\n        name: this.config.name,\n        version: this.config.version,\n      },\n      {\n        capabilities: {\n          resources: {},\n          tools: {},\n          prompts: {},\n          logging: {},\n        },\n        instructions: this.config.instructions ?? 'ObjectStack MCP Server — access data objects, AI tools, and agent prompts.',\n      },\n    );\n  }\n\n  /** The underlying McpServer instance (for advanced use cases). */\n  get server(): McpServer {\n    return this.mcpServer;\n  }\n\n  /** Whether the server is currently connected and running. */\n  get isStarted(): boolean {\n    return this.started;\n  }\n\n  // ── Helpers ─────────────────────────────────────────────────────\n\n  /**\n   * Extract the text value from a ToolExecutionResult's output.\n   *\n   * The output may be a `{ type: 'text', value: string }` object (from the\n   * Vercel AI SDK ToolResultPart) or any serialisable value.\n   */\n  private static formatToolOutput(result: ToolExecutionResult): string {\n    const output = result.output;\n    if (output && typeof output === 'object' && 'value' in output) {\n      return String((output as { value: unknown }).value);\n    }\n    return JSON.stringify(output ?? '');\n  }\n\n  // ── Tool Bridge ────────────────────────────────────────────────\n\n  /**\n   * Bridge all tools from the ToolRegistry to MCP tools.\n   *\n   * Each registered tool becomes an MCP tool with the same name, description,\n   * and JSON Schema parameters. The handler delegates to the ToolRegistry's\n   * execute path.\n   */\n  bridgeTools(toolRegistry: ToolRegistry): void {\n    const tools = toolRegistry.getAll();\n    const logger = this.config.logger;\n\n    for (const tool of tools) {\n      this.registerToolFromDefinition(tool, toolRegistry);\n    }\n\n    logger?.info(`[MCP] Bridged ${tools.length} tools from ToolRegistry`);\n  }\n\n  /**\n   * Register a single tool on the MCP server from an AIToolDefinition.\n   */\n  private registerToolFromDefinition(tool: AIToolDefinition, toolRegistry: ToolRegistry): void {\n    const logger = this.config.logger;\n\n    // Convert JSON Schema parameters to Zod-compatible format for MCP SDK\n    // The MCP SDK registerTool with inputSchema expects a Zod raw shape or AnySchema.\n    // Since our tools use JSON Schema, we use the low-level .tool() with a raw callback\n    // and pass the JSON Schema as annotations metadata.\n    this.mcpServer.registerTool(\n      tool.name,\n      {\n        description: tool.description,\n        annotations: {\n          // Mark tools with write side-effects for destructive operations\n          destructiveHint: this.isDestructiveTool(tool.name),\n          readOnlyHint: this.isReadOnlyTool(tool.name),\n          openWorldHint: false,\n        },\n      },\n      async (extra) => {\n        // The MCP SDK passes tool arguments via the extra.arguments property\n        // when registerTool is called without an inputSchema.\n        const rawExtra = extra as Record<string, unknown>;\n        const args = (rawExtra.arguments ?? {}) as Record<string, unknown>;\n\n        try {\n          const result = await toolRegistry.execute({\n            type: 'tool-call',\n            toolCallId: `mcp-${tool.name}-${Date.now()}`,\n            toolName: tool.name,\n            input: args,\n          });\n\n          const outputText = MCPServerRuntime.formatToolOutput(result);\n\n          if (result.isError) {\n            return {\n              content: [{ type: 'text' as const, text: outputText }],\n              isError: true,\n            };\n          }\n\n          return {\n            content: [{ type: 'text' as const, text: outputText }],\n          };\n        } catch (err) {\n          const message = err instanceof Error ? err.message : String(err);\n          logger?.warn(`[MCP] Tool \"${tool.name}\" execution failed:`, { error: message });\n          return {\n            content: [{ type: 'text' as const, text: message }],\n            isError: true,\n          };\n        }\n      },\n    );\n  }\n\n  /**\n   * Check if a tool is read-only (data query tools).\n   */\n  private isReadOnlyTool(name: string): boolean {\n    return READ_ONLY_TOOLS.has(name);\n  }\n\n  /**\n   * Check if a tool performs destructive operations.\n   */\n  private isDestructiveTool(name: string): boolean {\n    return DESTRUCTIVE_TOOLS.has(name);\n  }\n\n  // ── Resource Bridge ────────────────────────────────────────────\n\n  /**\n   * Bridge metadata service and data engine to MCP resources.\n   *\n   * Exposes:\n   * - `objectstack://objects` — List all data objects\n   * - `objectstack://objects/{objectName}` — Get object schema\n   * - `objectstack://objects/{objectName}/records/{recordId}` — Get a specific record\n   * - `objectstack://metadata/types` — List all metadata types\n   */\n  bridgeResources(metadataService: IMetadataService, dataEngine?: IDataEngine): void {\n    const logger = this.config.logger;\n    let resourceCount = 0;\n\n    // ── Static resource: List all objects ──\n    this.mcpServer.registerResource(\n      'object_list',\n      'objectstack://objects',\n      {\n        description: 'List all data objects (tables) in the ObjectStack instance',\n        mimeType: 'application/json',\n      },\n      async () => {\n        const objects = await metadataService.listObjects();\n        const summary = (objects as ObjectDef[]).map(o => ({\n          name: o.name,\n          label: o.label ?? o.name,\n          fieldCount: o.fields ? Object.keys(o.fields).length : 0,\n        }));\n\n        return {\n          contents: [{\n            uri: 'objectstack://objects',\n            mimeType: 'application/json',\n            text: JSON.stringify({ objects: summary, totalCount: summary.length }, null, 2),\n          }],\n        };\n      },\n    );\n    resourceCount++;\n\n    // ── Template resource: Object schema ──\n    this.mcpServer.registerResource(\n      'object_schema',\n      new ResourceTemplate('objectstack://objects/{objectName}', { list: undefined }),\n      {\n        description: 'Get the full schema of a specific data object including fields and features',\n        mimeType: 'application/json',\n      },\n      async (_uri, variables) => {\n        const objectName = String(variables.objectName);\n        const objectDef = await metadataService.getObject(objectName);\n\n        if (!objectDef) {\n          return {\n            contents: [{\n              uri: `objectstack://objects/${objectName}`,\n              mimeType: 'application/json',\n              text: JSON.stringify({ error: `Object \"${objectName}\" not found` }),\n            }],\n          };\n        }\n\n        const def = objectDef as ObjectDef;\n        const fields = def.fields ?? {};\n        const fieldSummary = Object.entries(fields).map(([key, f]) => ({\n          name: key,\n          type: f.type,\n          label: f.label ?? key,\n          required: f.required ?? false,\n        }));\n\n        return {\n          contents: [{\n            uri: `objectstack://objects/${objectName}`,\n            mimeType: 'application/json',\n            text: JSON.stringify({\n              name: def.name,\n              label: def.label ?? def.name,\n              fields: fieldSummary,\n              enableFeatures: def.enable ?? {},\n            }, null, 2),\n          }],\n        };\n      },\n    );\n    resourceCount++;\n\n    // ── Template resource: Record by ID ──\n    if (dataEngine) {\n      this.mcpServer.registerResource(\n        'record_by_id',\n        new ResourceTemplate('objectstack://objects/{objectName}/records/{recordId}', { list: undefined }),\n        {\n          description: 'Get a specific record by ID from a data object',\n          mimeType: 'application/json',\n        },\n        async (_uri, variables) => {\n          const objectName = String(variables.objectName);\n          const recordId = String(variables.recordId);\n\n          try {\n            const record = await dataEngine.findOne(objectName, {\n              where: { id: recordId },\n            });\n\n            if (!record) {\n              return {\n                contents: [{\n                  uri: `objectstack://objects/${objectName}/records/${recordId}`,\n                  mimeType: 'application/json',\n                  text: JSON.stringify({ error: `Record \"${recordId}\" not found in \"${objectName}\"` }),\n                }],\n              };\n            }\n\n            return {\n              contents: [{\n                uri: `objectstack://objects/${objectName}/records/${recordId}`,\n                mimeType: 'application/json',\n                text: JSON.stringify(record, null, 2),\n              }],\n            };\n          } catch (err) {\n            const message = err instanceof Error ? err.message : String(err);\n            return {\n              contents: [{\n                uri: `objectstack://objects/${objectName}/records/${recordId}`,\n                mimeType: 'application/json',\n                text: JSON.stringify({ error: message }),\n              }],\n            };\n          }\n        },\n      );\n      resourceCount++;\n    }\n\n    // ── Static resource: Metadata types ──\n    if (metadataService.getRegisteredTypes) {\n      this.mcpServer.registerResource(\n        'metadata_types',\n        'objectstack://metadata/types',\n        {\n          description: 'List all registered metadata types (object, app, view, agent, tool, etc.)',\n          mimeType: 'application/json',\n        },\n        async () => {\n          const types = await metadataService.getRegisteredTypes!();\n          return {\n            contents: [{\n              uri: 'objectstack://metadata/types',\n              mimeType: 'application/json',\n              text: JSON.stringify({ types, totalCount: types.length }, null, 2),\n            }],\n          };\n        },\n      );\n      resourceCount++;\n    }\n\n    logger?.info(`[MCP] Bridged ${resourceCount} resource endpoints`);\n  }\n\n  // ── Prompt Bridge ──────────────────────────────────────────────\n\n  /**\n   * Bridge registered agents to MCP prompts.\n   *\n   * Each active agent becomes an MCP prompt with:\n   * - Name matching the agent name\n   * - System message from agent instructions\n   * - Optional context arguments (objectName, recordId, viewName)\n   */\n  bridgePrompts(metadataService: IMetadataService): void {\n    const logger = this.config.logger;\n\n    // Register a dynamic prompt that loads agents at call time\n    this.mcpServer.registerPrompt(\n      'agent_prompt',\n      {\n        description: 'Load an agent\\'s system prompt with optional UI context. ' +\n          'Use the agentName argument to select which agent\\'s instructions to use.',\n        argsSchema: {\n          agentName: z.string().describe('Name of the agent to load (e.g. \"data_chat\", \"metadata_assistant\")'),\n          objectName: z.string().optional().describe('Current object the user is viewing'),\n          recordId: z.string().optional().describe('Currently selected record ID'),\n          viewName: z.string().optional().describe('Current view name'),\n        },\n      },\n      async (args) => {\n        const agentName = String(args.agentName ?? '');\n        if (!agentName) {\n          return {\n            messages: [{\n              role: 'user' as const,\n              content: { type: 'text' as const, text: 'Error: agentName argument is required' },\n            }],\n          };\n        }\n\n        const raw = await metadataService.get('agent', agentName);\n        if (!raw) {\n          return {\n            messages: [{\n              role: 'user' as const,\n              content: { type: 'text' as const, text: `Error: Agent \"${agentName}\" not found` },\n            }],\n          };\n        }\n\n        const agent = raw as Agent;\n\n        // Build system prompt from agent instructions + context\n        const parts: string[] = [];\n        parts.push(agent.instructions ?? '');\n\n        const contextHints: string[] = [];\n        if (args.objectName) contextHints.push(`Current object: ${args.objectName}`);\n        if (args.recordId) contextHints.push(`Selected record ID: ${args.recordId}`);\n        if (args.viewName) contextHints.push(`Current view: ${args.viewName}`);\n        if (contextHints.length > 0) {\n          parts.push('\\n--- Current Context ---\\n' + contextHints.join('\\n'));\n        }\n\n        return {\n          messages: [{\n            role: 'assistant' as const,\n            content: { type: 'text' as const, text: parts.join('\\n') },\n          }],\n        };\n      },\n    );\n\n    logger?.info('[MCP] Agent prompts bridged');\n  }\n\n  // ── Lifecycle ──────────────────────────────────────────────────\n\n  /**\n   * Start the MCP server with the configured transport.\n   *\n   * For stdio transport, this connects to process stdin/stdout.\n   */\n  async start(): Promise<void> {\n    if (this.started) return;\n\n    const logger = this.config.logger;\n\n    if (this.config.transport === 'stdio') {\n      this.transport = new StdioServerTransport();\n      await this.mcpServer.connect(this.transport);\n      this.started = true;\n      logger?.info(`[MCP] Server started (transport: stdio, name: ${this.config.name})`);\n    } else {\n      // HTTP transport support will be added in a future version\n      logger?.warn('[MCP] HTTP transport is not yet supported. Use stdio transport.');\n    }\n  }\n\n  /**\n   * Stop the MCP server and disconnect the transport.\n   */\n  async stop(): Promise<void> {\n    if (!this.started) return;\n\n    await this.mcpServer.close();\n    this.transport = undefined;\n    this.started = false;\n    this.config.logger?.info('[MCP] Server stopped');\n  }\n}\n","// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.\n\nimport type { Plugin, PluginContext } from '@objectstack/core';\nimport type { IAIService, IDataEngine, IMetadataService } from '@objectstack/spec/contracts';\nimport { MCPServerRuntime } from './mcp-server-runtime.js';\nimport type { MCPServerRuntimeConfig } from './mcp-server-runtime.js';\nimport type { ToolRegistry } from './types.js';\n\n/**\n * Configuration options for the MCPServerPlugin.\n */\nexport interface MCPServerPluginOptions {\n  /** Override MCP server name. Defaults to 'objectstack'. */\n  name?: string;\n  /** Override MCP server version. Defaults to package version. */\n  version?: string;\n  /** Transport mode: 'stdio' (default). */\n  transport?: 'stdio' | 'http';\n  /** Whether to auto-start the MCP server. Defaults to false (manual start via env var). */\n  autoStart?: boolean;\n  /** Custom instructions for the MCP server. */\n  instructions?: string;\n}\n\n/**\n * MCPServerPlugin — Kernel plugin that exposes ObjectStack as an MCP server.\n *\n * Lifecycle:\n * 1. **init** — Creates {@link MCPServerRuntime} and registers as `'mcp'` service.\n * 2. **start** — Bridges ToolRegistry, MetadataService, DataEngine, and Agents\n *    to the MCP server. Starts the transport if `autoStart` is enabled or\n *    the `MCP_SERVER_ENABLED` environment variable is set.\n * 3. **destroy** — Stops the MCP transport.\n *\n * Environment Variables:\n * - `MCP_SERVER_ENABLED=true` — Enable MCP server at startup\n * - `MCP_SERVER_NAME` — Override server name\n * - `MCP_SERVER_TRANSPORT` — Override transport ('stdio' | 'http')\n *\n * @example\n * ```ts\n * import { LiteKernel } from '@objectstack/core';\n * import { MCPServerPlugin } from '@objectstack/plugin-mcp-server';\n *\n * const kernel = new LiteKernel();\n * kernel.use(new MCPServerPlugin({ autoStart: true }));\n * await kernel.bootstrap();\n * ```\n */\nexport class MCPServerPlugin implements Plugin {\n  name = 'com.objectstack.plugin-mcp-server';\n  version = '1.0.0';\n  type = 'standard' as const;\n  dependencies: string[] = [];\n\n  private runtime?: MCPServerRuntime;\n  private readonly options: MCPServerPluginOptions;\n\n  constructor(options: MCPServerPluginOptions = {}) {\n    this.options = options;\n  }\n\n  async init(ctx: PluginContext): Promise<void> {\n    const config: MCPServerRuntimeConfig = {\n      name: process.env.MCP_SERVER_NAME ?? this.options.name ?? 'objectstack',\n      version: this.options.version ?? '1.0.0',\n      transport: (process.env.MCP_SERVER_TRANSPORT as 'stdio' | 'http') ?? this.options.transport ?? 'stdio',\n      instructions: this.options.instructions,\n      logger: ctx.logger,\n    };\n\n    this.runtime = new MCPServerRuntime(config);\n    ctx.registerService('mcp', this.runtime);\n\n    ctx.logger.info('[MCP] Plugin initialized');\n  }\n\n  async start(ctx: PluginContext): Promise<void> {\n    if (!this.runtime) return;\n\n    // ── Bridge tools from AIService ──\n    // The IAIService contract does not formally include `toolRegistry` because\n    // it is an implementation detail of AIService.  We use duck-typing here to\n    // avoid a hard dependency on @objectstack/service-ai while still bridging\n    // tools when the full AIService implementation is present.\n    try {\n      const aiService = ctx.getService<IAIService & { toolRegistry?: ToolRegistry }>('ai');\n      if (aiService?.toolRegistry) {\n        this.runtime.bridgeTools(aiService.toolRegistry);\n      } else {\n        ctx.logger.debug('[MCP] AI service does not expose a toolRegistry, skipping tool bridging');\n      }\n    } catch {\n      ctx.logger.debug('[MCP] AI service not available, skipping tool bridging');\n    }\n\n    // ── Bridge resources from MetadataService & DataEngine ──\n    let metadataService: IMetadataService | undefined;\n    let dataEngine: IDataEngine | undefined;\n\n    try {\n      metadataService = ctx.getService<IMetadataService>('metadata');\n    } catch {\n      ctx.logger.debug('[MCP] Metadata service not available, skipping resource bridging');\n    }\n\n    try {\n      dataEngine = ctx.getService<IDataEngine>('data');\n    } catch {\n      ctx.logger.debug('[MCP] Data engine not available, skipping record resources');\n    }\n\n    if (metadataService) {\n      this.runtime.bridgeResources(metadataService, dataEngine);\n      this.runtime.bridgePrompts(metadataService);\n    }\n\n    // ── Auto-start if configured ──\n    const shouldStart = this.options.autoStart || process.env.MCP_SERVER_ENABLED === 'true';\n    if (shouldStart) {\n      await this.runtime.start();\n      ctx.logger.info('[MCP] Server started automatically');\n    } else {\n      ctx.logger.info(\n        '[MCP] Server ready but not started. Set MCP_SERVER_ENABLED=true or use autoStart option.',\n      );\n    }\n\n    // Trigger hook for other plugins to extend MCP\n    await ctx.trigger('mcp:ready', this.runtime);\n  }\n\n  async destroy(): Promise<void> {\n    if (this.runtime?.isStarted) {\n      await this.runtime.stop();\n    }\n    this.runtime = undefined;\n  }\n}\n"],"mappings":"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","names":[]}