@riktajs/mcp 0.1.0

package/dist/decorators/mcp-resource.decorator.js

@@ -0,0 +1,66 @@
+/**
+ * @MCPResource Decorator
+ *
+ * Marks a method as an MCP resource provider.
+ *
+ * @example
+ * ```typescript
+ * import { Injectable } from '@riktajs/core';
+ * import { MCPResource } from '@riktajs/mcp';
+ *
+ * @Injectable()
+ * class FileService {
+ *   @MCPResource({
+ *     uriPattern: 'file://read',
+ *     name: 'Read File',
+ *     description: 'Read file contents by path',
+ *     mimeType: 'text/plain'
+ *   })
+ *   async readFile(uri: string) {
+ *     const url = new URL(uri);
+ *     const filePath = url.searchParams.get('path');
+ *     const content = await fs.readFile(filePath!, 'utf-8');
+ *     return {
+ *       contents: [{
+ *         uri,
+ *         text: content,
+ *         mimeType: 'text/plain'
+ *       }]
+ *     };
+ *   }
+ * }
+ * ```
+ */
+import 'reflect-metadata';
+import { MCP_RESOURCE_METADATA, MCP_HANDLERS_METADATA } from '../constants.js';
+/**
+ * @MCPResource() decorator
+ *
+ * Registers a method as an MCP resource provider.
+ *
+ * @param options - Resource configuration options
+ */
+export function MCPResource(options) {
+    return (target, propertyKey, descriptor) => {
+        // Set default mimeType if not provided
+        const optionsWithDefaults = {
+            mimeType: 'text/plain',
+            ...options,
+        };
+        // Store resource metadata on the method
+        Reflect.defineMetadata(MCP_RESOURCE_METADATA, optionsWithDefaults, target, propertyKey);
+        // Add to the class's list of MCP handlers
+        const handlers = Reflect.getMetadata(MCP_HANDLERS_METADATA, target.constructor) || [];
+        handlers.push({ type: 'resource', methodName: propertyKey });
+        Reflect.defineMetadata(MCP_HANDLERS_METADATA, handlers, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Get resource metadata from a method
+ * @internal
+ */
+export function getMCPResourceMetadata(target, propertyKey) {
+    return Reflect.getMetadata(MCP_RESOURCE_METADATA, target.prototype, propertyKey);
+}
+//# sourceMappingURL=mcp-resource.decorator.js.map

package/dist/decorators/mcp-resource.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-resource.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-resource.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG/E;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EACV,EAAE;QACtB,uCAAuC;QACvC,MAAM,mBAAmB,GAAuB;YAC9C,QAAQ,EAAE,YAAY;YACtB,GAAG,OAAO;SACX,CAAC;QAEF,wCAAwC;QACxC,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAExF,0CAA0C;QAC1C,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEvE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;QAC7D,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE5E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAgB,EAChB,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AACnF,CAAC"}

package/dist/decorators/mcp-tool.decorator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @MCPTool Decorator
+ *
+ * Marks a method as an MCP tool that can be called by AI assistants.
+ *
+ * @example
+ * ```typescript
+ * import { Injectable } from '@riktajs/core';
+ * import { MCPTool } from '@riktajs/mcp';
+ * import { z } from 'zod';
+ *
+ * @Injectable()
+ * class FileService {
+ *   @MCPTool({
+ *     name: 'read_file',
+ *     description: 'Read contents of a file',
+ *     inputSchema: z.object({
+ *       path: z.string().describe('File path to read')
+ *     })
+ *   })
+ *   async readFile(params: { path: string }) {
+ *     const content = await fs.readFile(params.path, 'utf-8');
+ *     return {
+ *       content: [{ type: 'text', text: content }]
+ *     };
+ *   }
+ * }
+ * ```
+ */
+import 'reflect-metadata';
+import type { MCPToolOptions } from '../types.js';
+/**
+ * @MCPTool() decorator
+ *
+ * Registers a method as an MCP tool that AI assistants can invoke.
+ *
+ * @param options - Tool configuration options
+ */
+export declare function MCPTool(options: MCPToolOptions): MethodDecorator;
+/**
+ * Get tool metadata from a method
+ * @internal
+ */
+export declare function getMCPToolMetadata(target: Function, propertyKey: string | symbol): MCPToolOptions | undefined;
+//# sourceMappingURL=mcp-tool.decorator.d.ts.map

package/dist/decorators/mcp-tool.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAkBhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,MAAM,GAAG,MAAM,GAC3B,cAAc,GAAG,SAAS,CAE5B"}

package/dist/decorators/mcp-tool.decorator.js

@@ -0,0 +1,57 @@
+/**
+ * @MCPTool Decorator
+ *
+ * Marks a method as an MCP tool that can be called by AI assistants.
+ *
+ * @example
+ * ```typescript
+ * import { Injectable } from '@riktajs/core';
+ * import { MCPTool } from '@riktajs/mcp';
+ * import { z } from 'zod';
+ *
+ * @Injectable()
+ * class FileService {
+ *   @MCPTool({
+ *     name: 'read_file',
+ *     description: 'Read contents of a file',
+ *     inputSchema: z.object({
+ *       path: z.string().describe('File path to read')
+ *     })
+ *   })
+ *   async readFile(params: { path: string }) {
+ *     const content = await fs.readFile(params.path, 'utf-8');
+ *     return {
+ *       content: [{ type: 'text', text: content }]
+ *     };
+ *   }
+ * }
+ * ```
+ */
+import 'reflect-metadata';
+import { MCP_TOOL_METADATA, MCP_HANDLERS_METADATA } from '../constants.js';
+/**
+ * @MCPTool() decorator
+ *
+ * Registers a method as an MCP tool that AI assistants can invoke.
+ *
+ * @param options - Tool configuration options
+ */
+export function MCPTool(options) {
+    return (target, propertyKey, descriptor) => {
+        // Store tool metadata on the method
+        Reflect.defineMetadata(MCP_TOOL_METADATA, options, target, propertyKey);
+        // Add to the class's list of MCP handlers
+        const handlers = Reflect.getMetadata(MCP_HANDLERS_METADATA, target.constructor) || [];
+        handlers.push({ type: 'tool', methodName: propertyKey });
+        Reflect.defineMetadata(MCP_HANDLERS_METADATA, handlers, target.constructor);
+        return descriptor;
+    };
+}
+/**
+ * Get tool metadata from a method
+ * @internal
+ */
+export function getMCPToolMetadata(target, propertyKey) {
+    return Reflect.getMetadata(MCP_TOOL_METADATA, target.prototype, propertyKey);
+}
+//# sourceMappingURL=mcp-tool.decorator.js.map

package/dist/decorators/mcp-tool.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool.decorator.js","sourceRoot":"","sources":["../../src/decorators/mcp-tool.decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG3E;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAA8B,EACV,EAAE;QACtB,oCAAoC;QACpC,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAExE,0CAA0C;QAC1C,MAAM,QAAQ,GACZ,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAEvE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,QAAQ,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAE5E,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAgB,EAChB,WAA4B;IAE5B,OAAO,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC/E,CAAC"}

package/dist/discovery/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @riktajs/mcp - Discovery
+ *
+ * Export MCP registry and discovery utilities.
+ */
+export { mcpRegistry, MCPRegistryImpl } from './mcp-registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1,7 @@
+/**
+ * @riktajs/mcp - Discovery
+ *
+ * Export MCP registry and discovery utilities.
+ */
+export { mcpRegistry, MCPRegistryImpl } from './mcp-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/discovery/mcp-registry.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @riktajs/mcp - MCP Registry
+ *
+ * Discovers and stores MCP handlers (tools, resources, prompts) from decorated classes.
+ * Works with Rikta's registry to auto-discover @Injectable classes with MCP decorators.
+ */
+import 'reflect-metadata';
+import type { RegisteredMCPTool, RegisteredMCPResource, RegisteredMCPPrompt } from '../types.js';
+type Constructor<T = unknown> = new (...args: unknown[]) => T;
+/**
+ * MCP Registry
+ *
+ * Central registry for all discovered MCP handlers.
+ * Scans @Injectable classes for @MCPTool, @MCPResource, @MCPPrompt decorators.
+ */
+declare class MCPRegistryImpl {
+    private static instance;
+    /** Registered tools */
+    private tools;
+    /** Registered resources */
+    private resources;
+    /** Registered prompts */
+    private prompts;
+    /** Classes that have been scanned */
+    private scannedClasses;
+    private constructor();
+    static getInstance(): MCPRegistryImpl;
+    /**
+     * Reset the registry (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Scan a class for MCP decorators and register found handlers
+     *
+     * @param target - Class constructor to scan
+     * @param instance - Instance of the class (for binding handlers)
+     */
+    scanClass(target: Constructor, instance: unknown): void;
+    /**
+     * Register a tool from a class method
+     */
+    private registerTool;
+    /**
+     * Register a resource from a class method
+     */
+    private registerResource;
+    /**
+     * Register a prompt from a class method
+     */
+    private registerPrompt;
+    /**
+     * Get all registered tools
+     */
+    getTools(): RegisteredMCPTool[];
+    /**
+     * Get all registered resources
+     */
+    getResources(): RegisteredMCPResource[];
+    /**
+     * Get all registered prompts
+     */
+    getPrompts(): RegisteredMCPPrompt[];
+    /**
+     * Check if a class has MCP handlers
+     */
+    hasMCPHandlers(target: Constructor): boolean;
+    /**
+     * Get count of all registered handlers
+     */
+    getStats(): {
+        tools: number;
+        resources: number;
+        prompts: number;
+    };
+}
+/** Singleton instance of MCP registry */
+export declare const mcpRegistry: MCPRegistryImpl;
+/** Export class for testing */
+export { MCPRegistryImpl };
+//# sourceMappingURL=mcp-registry.d.ts.map

package/dist/discovery/mcp-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.d.ts","sourceRoot":"","sources":["../../src/discovery/mcp-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,kBAAkB,CAAC;AAO1B,OAAO,KAAK,EAIV,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAGrB,KAAK,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAU9D;;;;;GAKG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IAEzC,uBAAuB;IACvB,OAAO,CAAC,KAAK,CAA2B;IAExC,2BAA2B;IAC3B,OAAO,CAAC,SAAS,CAA+B;IAEhD,yBAAyB;IACzB,OAAO,CAAC,OAAO,CAA6B;IAE5C,qCAAqC;IACrC,OAAO,CAAC,cAAc,CAAuB;IAE7C,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,eAAe;IAOrC;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAKpB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IA2BvD;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;OAEG;IACH,QAAQ,IAAI,iBAAiB,EAAE;IAI/B;;OAEG;IACH,YAAY,IAAI,qBAAqB,EAAE;IAIvC;;OAEG;IACH,UAAU,IAAI,mBAAmB,EAAE;IAInC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAK5C;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAOlE;AAED,yCAAyC;AACzC,eAAO,MAAM,WAAW,iBAAgC,CAAC;AAEzD,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/discovery/mcp-registry.js

@@ -0,0 +1,179 @@
+/**
+ * @riktajs/mcp - MCP Registry
+ *
+ * Discovers and stores MCP handlers (tools, resources, prompts) from decorated classes.
+ * Works with Rikta's registry to auto-discover @Injectable classes with MCP decorators.
+ */
+import 'reflect-metadata';
+import { MCP_TOOL_METADATA, MCP_RESOURCE_METADATA, MCP_PROMPT_METADATA, MCP_HANDLERS_METADATA, } from '../constants.js';
+/**
+ * MCP Registry
+ *
+ * Central registry for all discovered MCP handlers.
+ * Scans @Injectable classes for @MCPTool, @MCPResource, @MCPPrompt decorators.
+ */
+class MCPRegistryImpl {
+    static instance;
+    /** Registered tools */
+    tools = [];
+    /** Registered resources */
+    resources = [];
+    /** Registered prompts */
+    prompts = [];
+    /** Classes that have been scanned */
+    scannedClasses = new Set();
+    constructor() { }
+    static getInstance() {
+        if (!MCPRegistryImpl.instance) {
+            MCPRegistryImpl.instance = new MCPRegistryImpl();
+        }
+        return MCPRegistryImpl.instance;
+    }
+    /**
+     * Reset the registry (useful for testing)
+     */
+    static reset() {
+        const newInstance = new MCPRegistryImpl();
+        MCPRegistryImpl.instance = newInstance;
+    }
+    /**
+     * Scan a class for MCP decorators and register found handlers
+     *
+     * @param target - Class constructor to scan
+     * @param instance - Instance of the class (for binding handlers)
+     */
+    scanClass(target, instance) {
+        // Skip if already scanned
+        if (this.scannedClasses.has(target)) {
+            return;
+        }
+        this.scannedClasses.add(target);
+        // Get all MCP handlers registered on this class
+        const handlers = Reflect.getMetadata(MCP_HANDLERS_METADATA, target) || [];
+        for (const handler of handlers) {
+            const { type, methodName } = handler;
+            switch (type) {
+                case 'tool':
+                    this.registerTool(target, instance, methodName);
+                    break;
+                case 'resource':
+                    this.registerResource(target, instance, methodName);
+                    break;
+                case 'prompt':
+                    this.registerPrompt(target, instance, methodName);
+                    break;
+            }
+        }
+    }
+    /**
+     * Register a tool from a class method
+     */
+    registerTool(target, instance, methodName) {
+        const metadata = Reflect.getMetadata(MCP_TOOL_METADATA, target.prototype, methodName);
+        if (!metadata) {
+            return;
+        }
+        // Check for duplicate tool names
+        if (this.tools.some(t => t.name === metadata.name)) {
+            console.warn(`[MCP] Duplicate tool name: ${metadata.name}. Skipping.`);
+            return;
+        }
+        const handler = instance[methodName];
+        this.tools.push({
+            name: metadata.name,
+            description: metadata.description,
+            inputSchema: metadata.inputSchema,
+            handler: handler.bind(instance),
+            targetClass: target,
+            methodName,
+        });
+    }
+    /**
+     * Register a resource from a class method
+     */
+    registerResource(target, instance, methodName) {
+        const metadata = Reflect.getMetadata(MCP_RESOURCE_METADATA, target.prototype, methodName);
+        if (!metadata) {
+            return;
+        }
+        // Check for duplicate resource patterns
+        if (this.resources.some(r => r.uriPattern === metadata.uriPattern)) {
+            console.warn(`[MCP] Duplicate resource URI pattern: ${metadata.uriPattern}. Skipping.`);
+            return;
+        }
+        const handler = instance[methodName];
+        this.resources.push({
+            uriPattern: metadata.uriPattern,
+            name: metadata.name,
+            description: metadata.description,
+            mimeType: metadata.mimeType || 'text/plain',
+            uriSchema: metadata.uriSchema,
+            handler: handler.bind(instance),
+            targetClass: target,
+            methodName,
+        });
+    }
+    /**
+     * Register a prompt from a class method
+     */
+    registerPrompt(target, instance, methodName) {
+        const metadata = Reflect.getMetadata(MCP_PROMPT_METADATA, target.prototype, methodName);
+        if (!metadata) {
+            return;
+        }
+        // Check for duplicate prompt names
+        if (this.prompts.some(p => p.name === metadata.name)) {
+            console.warn(`[MCP] Duplicate prompt name: ${metadata.name}. Skipping.`);
+            return;
+        }
+        const handler = instance[methodName];
+        this.prompts.push({
+            name: metadata.name,
+            description: metadata.description,
+            arguments: metadata.arguments,
+            handler: handler.bind(instance),
+            targetClass: target,
+            methodName,
+        });
+    }
+    /**
+     * Get all registered tools
+     */
+    getTools() {
+        return [...this.tools];
+    }
+    /**
+     * Get all registered resources
+     */
+    getResources() {
+        return [...this.resources];
+    }
+    /**
+     * Get all registered prompts
+     */
+    getPrompts() {
+        return [...this.prompts];
+    }
+    /**
+     * Check if a class has MCP handlers
+     */
+    hasMCPHandlers(target) {
+        const handlers = Reflect.getMetadata(MCP_HANDLERS_METADATA, target);
+        return Array.isArray(handlers) && handlers.length > 0;
+    }
+    /**
+     * Get count of all registered handlers
+     */
+    getStats() {
+        return {
+            tools: this.tools.length,
+            resources: this.resources.length,
+            prompts: this.prompts.length,
+        };
+    }
+}
+/** Singleton instance of MCP registry */
+export const mcpRegistry = MCPRegistryImpl.getInstance();
+/** Export class for testing */
+export { MCPRegistryImpl };
+//# sourceMappingURL=mcp-registry.js.map

package/dist/discovery/mcp-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.js","sourceRoot":"","sources":["../../src/discovery/mcp-registry.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @riktajs/mcp
+ *
+ * Model Context Protocol (MCP) integration for Rikta Framework.
+ * Connect AI assistants like Claude and GPT to your Rikta backend.
+ *
+ * This package provides decorators and utilities to expose your services
+ * as MCP tools, resources, and prompts that AI assistants can use.
+ *
+ * Features:
+ * - Decorator-based API (@MCPTool, @MCPResource, @MCPPrompt)
+ * - Auto-discovery of MCP handlers from @Injectable classes
+ * - Zod schema integration for input validation
+ * - SSE (Server-Sent Events) support for real-time notifications
+ * - Redis support for horizontal scaling
+ * - Full TypeScript support
+ *
+ * @example
+ * ```typescript
+ * import { Rikta, Injectable } from '@riktajs/core';
+ * import { registerMCPServer, MCPTool, MCPResource } from '@riktajs/mcp';
+ * import { z } from 'zod';
+ *
+ * @Injectable()
+ * class FileService {
+ *   @MCPTool({
+ *     name: 'list_files',
+ *     description: 'List files in a directory',
+ *     inputSchema: z.object({
+ *       path: z.string().describe('Directory path')
+ *     })
+ *   })
+ *   async listFiles(params: { path: string }) {
+ *     const files = await fs.readdir(params.path);
+ *     return {
+ *       content: [{ type: 'text', text: files.join('\n') }]
+ *     };
+ *   }
+ *
+ *   @MCPResource({
+ *     uriPattern: 'file://read',
+ *     name: 'Read File',
+ *     description: 'Read file contents'
+ *   })
+ *   async readFile(uri: string) {
+ *     const url = new URL(uri);
+ *     const content = await fs.readFile(url.searchParams.get('path')!, 'utf-8');
+ *     return {
+ *       contents: [{ uri, text: content, mimeType: 'text/plain' }]
+ *     };
+ *   }
+ * }
+ *
+ * const app = await Rikta.create({ port: 3000 });
+ *
+ * await registerMCPServer(app, {
+ *   serverInfo: { name: 'file-server', version: '1.0.0' },
+ *   instructions: 'A file system server for reading and listing files',
+ * });
+ *
+ * await app.listen();
+ * // MCP available at http://localhost:3000/mcp
+ * // - POST /mcp for JSON-RPC requests
+ * // - GET /mcp for SSE connections
+ * ```
+ *
+ * @packageDocumentation
+ */
+export * from './constants.js';
+export type * from './types.js';
+export * from './decorators/index.js';
+export { mcpRegistry } from './discovery/index.js';
+export { zodToMCPSchema, toMCPSchema, isZodSchema } from './utils/index.js';
+export { registerMCPServer, createMCPConfig, mcpServerPlugin } from './plugin/index.js';
+export { z } from 'zod';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAGH,cAAc,gBAAgB,CAAC;AAG/B,mBAAmB,YAAY,CAAC;AAGhC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG5E,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGxF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,81 @@
+/**
+ * @riktajs/mcp
+ *
+ * Model Context Protocol (MCP) integration for Rikta Framework.
+ * Connect AI assistants like Claude and GPT to your Rikta backend.
+ *
+ * This package provides decorators and utilities to expose your services
+ * as MCP tools, resources, and prompts that AI assistants can use.
+ *
+ * Features:
+ * - Decorator-based API (@MCPTool, @MCPResource, @MCPPrompt)
+ * - Auto-discovery of MCP handlers from @Injectable classes
+ * - Zod schema integration for input validation
+ * - SSE (Server-Sent Events) support for real-time notifications
+ * - Redis support for horizontal scaling
+ * - Full TypeScript support
+ *
+ * @example
+ * ```typescript
+ * import { Rikta, Injectable } from '@riktajs/core';
+ * import { registerMCPServer, MCPTool, MCPResource } from '@riktajs/mcp';
+ * import { z } from 'zod';
+ *
+ * @Injectable()
+ * class FileService {
+ *   @MCPTool({
+ *     name: 'list_files',
+ *     description: 'List files in a directory',
+ *     inputSchema: z.object({
+ *       path: z.string().describe('Directory path')
+ *     })
+ *   })
+ *   async listFiles(params: { path: string }) {
+ *     const files = await fs.readdir(params.path);
+ *     return {
+ *       content: [{ type: 'text', text: files.join('\n') }]
+ *     };
+ *   }
+ *
+ *   @MCPResource({
+ *     uriPattern: 'file://read',
+ *     name: 'Read File',
+ *     description: 'Read file contents'
+ *   })
+ *   async readFile(uri: string) {
+ *     const url = new URL(uri);
+ *     const content = await fs.readFile(url.searchParams.get('path')!, 'utf-8');
+ *     return {
+ *       contents: [{ uri, text: content, mimeType: 'text/plain' }]
+ *     };
+ *   }
+ * }
+ *
+ * const app = await Rikta.create({ port: 3000 });
+ *
+ * await registerMCPServer(app, {
+ *   serverInfo: { name: 'file-server', version: '1.0.0' },
+ *   instructions: 'A file system server for reading and listing files',
+ * });
+ *
+ * await app.listen();
+ * // MCP available at http://localhost:3000/mcp
+ * // - POST /mcp for JSON-RPC requests
+ * // - GET /mcp for SSE connections
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Export constants
+export * from './constants.js';
+// Export decorators
+export * from './decorators/index.js';
+// Export discovery/registry
+export { mcpRegistry } from './discovery/index.js';
+// Export utilities
+export { zodToMCPSchema, toMCPSchema, isZodSchema } from './utils/index.js';
+// Export plugin
+export { registerMCPServer, createMCPConfig, mcpServerPlugin } from './plugin/index.js';
+// Re-export zod for convenience
+export { z } from 'zod';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,mBAAmB;AACnB,cAAc,gBAAgB,CAAC;AAK/B,oBAAoB;AACpB,cAAc,uBAAuB,CAAC;AAEtC,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE5E,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAExF,gCAAgC;AAChC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/plugin/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @riktajs/mcp - Plugin
+ *
+ * Export MCP plugin and registration functions.
+ */
+export { registerMCPServer, createMCPConfig, mcpServerPlugin } from './mcp.plugin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1,7 @@
+/**
+ * @riktajs/mcp - Plugin
+ *
+ * Export MCP plugin and registration functions.
+ */
+export { registerMCPServer, createMCPConfig, mcpServerPlugin } from './mcp.plugin.js';
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}