@jrmc/adonis-mcp 1.0.0-beta.8 → 1.0.0

package/README.md

@@ -28,16 +28,15 @@ AdonisJS MCP - Server MCP for your AdonisJS applications.
 - [x] Documentation
 - [x] Inject support
 - [x] VineJs integration
-- [ ] JSON Schema with VineJs
-- [ ] Bounce integration (WIP)
-- [ ] Auth helpers (WIP)
-- [ ] Events
-- [ ] Logger
+- [x] JSON Schema with VineJs
+- [x] Bounce integration
+- [x] Auth helpers
+- [x] Starter kit
+- [x] Demo applications
+- [x] Events
+- [x] Logger
 - [ ] Alternative transports (SSE)
 - [ ] Output tool
-- [ ] Login flow
-- [ ] Starter kit
-- [ ] Demo applications
 
 ## Installation & Configuration
 
@@ -192,10 +191,10 @@ To use `auth` and `bouncer` in your MCP tools, prompts, and resources, add the f
 ```typescript
 declare module '@jrmc/adonis-mcp/types/context' {
   export interface McpContext {
-    auth?: {
+    auth: {
       user?: HttpContext['auth']['user']
     }
-    bouncer?: Bouncer<
+    bouncer: McpBouncer<
       Exclude<HttpContext['auth']['user'], undefined>,
       typeof abilities,
       typeof policies

package/build/commands/commands.json

@@ -1 +1 @@
-{"commands":[{"commandName":"mcp:inspector","description":"Open the MCP Inspector tool to debug and test MCP Servers.","help":"","namespace":"mcp","aliases":[],"flags":[],"args":[{"name":"transport","argumentName":"transport","required":true,"description":"Transport type","default":"http","type":"string"}],"options":{"startApp":true},"filePath":"inspector.js"},{"commandName":"make:mcp-prompt","description":"Create a new MCP prompt","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the prompt","type":"string"}],"options":{"startApp":true},"filePath":"make/prompt.js"},{"commandName":"make:mcp-resource","description":"Create a new MCP resource","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the resource","type":"string"}],"options":{"startApp":true},"filePath":"make/resource.js"},{"commandName":"make:mcp-tool","description":"Create a new MCP tool","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the tool","type":"string"}],"options":{"startApp":true},"filePath":"make/tool.js"},{"commandName":"mcp:start","description":"Start the MCP server stdio transport","help":"","namespace":"mcp","aliases":[],"flags":[],"args":[],"options":{"startApp":true},"filePath":"start.js"}],"version":1}
+{"commands":[{"commandName":"mcp:inspector","description":"Open the MCP Inspector tool to debug and test MCP Servers.","help":"","namespace":"mcp","aliases":["mcp:inspect"],"flags":[],"args":[{"name":"transport","argumentName":"transport","required":true,"description":"Transport type","default":"http","type":"string"}],"options":{"startApp":true},"filePath":"inspector.js"},{"commandName":"make:mcp-prompt","description":"Create a new MCP prompt","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the prompt","type":"string"}],"options":{"startApp":true},"filePath":"make/prompt.js"},{"commandName":"make:mcp-resource","description":"Create a new MCP resource","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the resource","type":"string"}],"options":{"startApp":true},"filePath":"make/resource.js"},{"commandName":"make:mcp-tool","description":"Create a new MCP tool","help":"","namespace":"make","aliases":[],"flags":[],"args":[{"name":"name","argumentName":"name","required":true,"description":"Name of the tool","type":"string"}],"options":{"startApp":true},"filePath":"make/tool.js"},{"commandName":"mcp:start","description":"Start the MCP server stdio transport","help":"","namespace":"mcp","aliases":[],"flags":[],"args":[],"options":{"startApp":true},"filePath":"start.js"}],"version":1}

package/build/commands/inspector.d.ts

@@ -9,6 +9,7 @@ import { BaseCommand } from '@adonisjs/core/ace';
 export default class Inspector extends BaseCommand {
     static commandName: string;
     static description: string;
+    static aliases: string[];
     static options: CommandOptions;
     transport: string;
     run(): Promise<void>;

package/build/commands/inspector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../commands/inspector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D,OAAO,EAAQ,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,SAAkB;IACpC,MAAM,CAAC,WAAW,SAA+D;IAEjF,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAGO,SAAS,EAAE,MAAM,CAAA;IAEnB,GAAG;CAoCV"}
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../commands/inspector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D,OAAO,EAAQ,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,WAAW;IAChD,MAAM,CAAC,WAAW,SAAkB;IACpC,MAAM,CAAC,WAAW,SAA+D;IACjF,MAAM,CAAC,OAAO,WAAkB;IAEhC,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAGO,SAAS,EAAE,MAAM,CAAA;IAEnB,GAAG;CAoCV"}

package/build/commands/inspector.js

@@ -15,6 +15,7 @@ import { args, BaseCommand } from '@adonisjs/core/ace';
 export default class Inspector extends BaseCommand {
     static commandName = 'mcp:inspector';
     static description = 'Open the MCP Inspector tool to debug and test MCP Servers.';
+    static aliases = ['mcp:inspect'];
     static options = {
         startApp: true,
     };

package/build/commands/make/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../commands/make/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAQ,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAItD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,WAAW,SAAoB;IACtC,MAAM,CAAC,WAAW,SAA4B;IAE9C,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAGO,IAAI,EAAE,MAAM,CAAA;IAEd,GAAG;CAUV"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../commands/make/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAQ,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAItD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW;IACjD,MAAM,CAAC,WAAW,SAAoB;IACtC,MAAM,CAAC,WAAW,SAA4B;IAE9C,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAGO,IAAI,EAAE,MAAM,CAAA;IAEd,GAAG;CAcV"}

package/build/commands/make/prompt.js

@@ -21,7 +21,10 @@ export default class MakePrompt extends BaseCommand {
     };
     async run() {
         const codemods = await this.createCodemods();
-        const stubPath = `make/mcp/prompts/main.ts.stub`;
+        let stubPath = `make/mcp/prompts/main.ts.stub`;
+        if (this.app.usingVineJS) {
+            stubPath = `make/mcp/prompts/with_vine.ts.stub`;
+        }
         await codemods.makeUsingStub(stubsRoot, stubPath, {
             name: string.pascalCase(this.name),
         });

package/build/commands/make/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../commands/make/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAQ,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAItD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,SAAkB;IACpC,MAAM,CAAC,WAAW,SAA0B;IAE5C,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAGO,IAAI,EAAE,MAAM,CAAA;IAEd,GAAG;CAUV"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../commands/make/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,EAAQ,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAItD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;IAC/C,MAAM,CAAC,WAAW,SAAkB;IACpC,MAAM,CAAC,WAAW,SAA0B;IAE5C,MAAM,CAAC,OAAO,EAAE,cAAc,CAE7B;IAGO,IAAI,EAAE,MAAM,CAAA;IAEd,GAAG;CAcV"}

package/build/commands/make/tool.js

@@ -21,7 +21,10 @@ export default class MakeTool extends BaseCommand {
     };
     async run() {
         const codemods = await this.createCodemods();
-        const stubPath = `make/mcp/tools/main.ts.stub`;
+        let stubPath = `make/mcp/tools/main.ts.stub`;
+        if (this.app.usingVineJS) {
+            stubPath = `make/mcp/tools/with_vine.ts.stub`;
+        }
         await codemods.makeUsingStub(stubsRoot, stubPath, {
             name: string.pascalCase(this.name),
         });

package/build/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAA;AAG9D,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBA4BjD"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAA;AAI9D,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAsCjD"}

package/build/configure.js

@@ -4,9 +4,19 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
+import { mkdir } from 'node:fs/promises';
 import { stubsRoot } from './stubs/main.js';
 export async function configure(command) {
     const codemods = await command.createCodemods();
+    /**
+     * Create mcp directory if it doesn't exist
+     */
+    const mcpDirectory = command.app.rcFile.directories['mcp'] || 'app/mcp/';
+    await Promise.all([
+        mkdir(command.app.makePath(mcpDirectory, 'tools'), { recursive: true }),
+        mkdir(command.app.makePath(mcpDirectory, 'resources'), { recursive: true }),
+        mkdir(command.app.makePath(mcpDirectory, 'prompts'), { recursive: true }),
+    ]);
     /**
      * Create default config file
      */

package/build/providers/mcp_provider.d.ts

@@ -6,6 +6,7 @@
  */
 import type { ApplicationService } from '@adonisjs/core/types';
 import type { RouteGroup } from '@adonisjs/core/http';
+import type { JsonRpcRequest, JsonRpcResponse } from '../src/types/jsonrpc.js';
 import McpServer from '../src/server.js';
 export default class McpProvider {
     protected app: ApplicationService;
@@ -26,5 +27,9 @@ declare module '@adonisjs/core/types' {
     interface ContainerBindings {
         'jrmc.mcp': McpServer;
     }
+    interface EventsList {
+        'mcp:request': JsonRpcRequest;
+        'mcp:response': JsonRpcResponse;
+    }
 }
 //# sourceMappingURL=mcp_provider.d.ts.map

package/build/providers/mcp_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp_provider.d.ts","sourceRoot":"","sources":["../../providers/mcp_provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAMrD,OAAO,SAAS,MAAM,kBAAkB,CAAA;AAExC,MAAM,CAAC,OAAO,OAAO,WAAW;IAClB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;IAQF,KAAK;IAeL,aAAa;IAIb,iBAAiB;IAIjB,eAAe;IAIf,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ;CA6C3D;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,MAAM;QACd,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,UAAU,CAAA;KACtC;CACF;AAED,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,UAAU,EAAE,SAAS,CAAA;KACtB;CACF"}
+{"version":3,"file":"mcp_provider.d.ts","sourceRoot":"","sources":["../../providers/mcp_provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAK9E,OAAO,SAAS,MAAM,kBAAkB,CAAA;AAExC,MAAM,CAAC,OAAO,OAAO,WAAW;IAClB,SAAS,CAAC,GAAG,EAAE,kBAAkB;gBAAvB,GAAG,EAAE,kBAAkB;IAE7C,QAAQ;IAUF,KAAK;IAeL,aAAa;IAIb,iBAAiB;IAIjB,eAAe;IAIf,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ;CA6C3D;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,MAAM;QACd,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,UAAU,CAAA;KACtC;CACF;AAED,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,iBAAiB;QACzB,UAAU,EAAE,SAAS,CAAA;KACtB;IAED,UAAU,UAAU;QAClB,aAAa,EAAE,cAAc,CAAA;QAC7B,cAAc,EAAE,eAAe,CAAA;KAChC;CACF"}

package/build/providers/mcp_provider.js

@@ -16,7 +16,9 @@ export default class McpProvider {
     register() {
         this.app.container.singleton('jrmc.mcp', async () => {
             const config = this.app.config.get('mcp', {});
-            return new McpServer(config);
+            const logger = await this.app.container.make('logger');
+            const emitter = await this.app.container.make('emitter');
+            return new McpServer(config, { logger, emitter });
         });
     }
     async start() {

package/build/src/server/mcp_bouncer.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @jrmc/adonis-mcp
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { type Bouncer, AuthorizationResponse } from '@adonisjs/bouncer';
+import type { LazyImport, Constructor, BouncerAbility, AuthorizerResponse, NarrowAbilitiesForAUser } from '@adonisjs/bouncer/types';
+/**
+ * Given a Bouncer instance type, extract the return type of `.with(policy)`
+ * so we can wrap it without importing the unexported PolicyAuthorizer class.
+ */
+type PolicyAuthorizerOf<B extends Bouncer<any, any, any>, Policy> = B extends {
+    with(policy: Policy): infer R;
+} ? R : never;
+/**
+ * Replaces each async method's return‑type with one that converts
+ * E_AUTHORIZATION_FAILURE → JsonRpcException, while keeping the
+ * original parameter signatures intact.
+ */
+type WrappedPolicyAuthorizer<T> = {
+    [K in keyof T]: T[K] extends (...args: infer A) => Promise<infer R> ? (...args: A) => Promise<R> : T[K];
+};
+/**
+ * McpBouncer wraps the AdonisJS Bouncer instance and converts
+ * authorization exceptions (`E_AUTHORIZATION_FAILURE`) into
+ * `JsonRpcException` so they are properly serialized as JSON-RPC
+ * error responses instead of leaking HTTP-centric error handling.
+ *
+ * Every public method signature is kept identical to the original
+ * Bouncer class so that consumers get full type-safety.
+ */
+export default class McpBouncer<User extends Record<any, any>, Abilities extends Record<string, BouncerAbility<any>> | undefined = undefined, Policies extends Record<string, LazyImport<Constructor<any>>> | undefined = undefined> {
+    #private;
+    constructor(bouncer: Bouncer<User, Abilities, Policies>, requestId: string | number);
+    /**
+     * Access the underlying bouncer abilities.
+     */
+    get abilities(): Abilities | undefined;
+    /**
+     * Access the underlying bouncer policies.
+     */
+    get policies(): Policies | undefined;
+    /**
+     * Returns a wrapped PolicyAuthorizer for a pre-registered policy name.
+     */
+    with<Policy extends keyof Policies>(policy: Policy): Policies extends Record<string, LazyImport<Constructor<any>>> ? WrappedPolicyAuthorizer<PolicyAuthorizerOf<Bouncer<User, Abilities, Policies>, Policy>> : never;
+    /**
+     * Returns a wrapped PolicyAuthorizer for a policy class constructor.
+     */
+    with<Policy extends Constructor<any>>(policy: Policy): WrappedPolicyAuthorizer<PolicyAuthorizerOf<Bouncer<User, Abilities, Policies>, Policy>>;
+    /**
+     * Execute an ability by reference.
+     */
+    execute<Ability extends BouncerAbility<User>>(ability: Ability, ...args: Ability extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<AuthorizationResponse>;
+    /**
+     * Execute an ability from the list of pre-defined abilities.
+     */
+    execute<Ability extends NarrowAbilitiesForAUser<User, Abilities>>(ability: Ability, ...args: Abilities[Ability] extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<AuthorizationResponse>;
+    /**
+     * Check if a user is allowed to perform an action using
+     * the ability provided by reference.
+     */
+    allows<Ability extends BouncerAbility<User>>(ability: Ability, ...args: Ability extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<boolean>;
+    /**
+     * Check if a user is allowed to perform an action using
+     * the ability from the pre-defined list of abilities.
+     */
+    allows<Ability extends NarrowAbilitiesForAUser<User, Abilities>>(ability: Ability, ...args: Abilities[Ability] extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<boolean>;
+    /**
+     * Check if a user is denied from performing an action using
+     * the ability provided by reference.
+     */
+    denies<Action extends BouncerAbility<User>>(action: Action, ...args: Action extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<boolean>;
+    /**
+     * Check if a user is denied from performing an action using
+     * the ability from the pre-defined list of abilities.
+     */
+    denies<Action extends NarrowAbilitiesForAUser<User, Abilities>>(action: Action, ...args: Abilities[Action] extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<boolean>;
+    /**
+     * Authorize a user against a given ability.
+     *
+     * @throws {JsonRpcException}
+     */
+    authorize<Action extends BouncerAbility<User>>(action: Action, ...args: Action extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<void>;
+    /**
+     * Authorize a user against a given ability.
+     *
+     * @throws {JsonRpcException}
+     */
+    authorize<Ability extends NarrowAbilitiesForAUser<User, Abilities>>(ability: Ability, ...args: Abilities[Ability] extends {
+        original: (user: User, ...args: infer Args) => AuthorizerResponse | Promise<AuthorizerResponse>;
+    } ? Args : never): Promise<void>;
+    /**
+     * Create AuthorizationResponse to deny access.
+     * This is a pass-through since it doesn't throw.
+     */
+    deny(message: string, status?: number): AuthorizationResponse;
+}
+export {};
+//# sourceMappingURL=mcp_bouncer.d.ts.map

package/build/src/server/mcp_bouncer.d.ts.map

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

package/build/src/server/mcp_bouncer.js

@@ -0,0 +1,123 @@
+/**
+ * @jrmc/adonis-mcp
+ *
+ * @license MIT
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
+ */
+import { errors } from '@adonisjs/bouncer';
+import { ErrorCode } from '../enums/error.js';
+import JsonRpcException from './exceptions/jsonrpc_exception.js';
+/**
+ * Convert any caught error to a JsonRpcException.
+ */
+function handleError(error, requestId) {
+    if (error instanceof errors.E_AUTHORIZATION_FAILURE) {
+        const message = error.response?.message || error.message || 'Access denied';
+        throw new JsonRpcException(message, ErrorCode.InvalidRequest, requestId);
+    }
+    if (error instanceof JsonRpcException) {
+        throw error;
+    }
+    const message = error instanceof Error ? error.message : 'Authorization error';
+    throw new JsonRpcException(message, ErrorCode.InternalError, requestId);
+}
+/**
+ * Wrap a PolicyAuthorizer so that every async method (`execute`,
+ * `allows`, `denies`, `authorize`) converts authorization failures
+ * into JsonRpcException.
+ */
+function wrapPolicyAuthorizer(authorizer, requestId) {
+    const wrapped = ['execute', 'allows', 'denies', 'authorize'];
+    return new Proxy(authorizer, {
+        get(target, prop, receiver) {
+            const value = Reflect.get(target, prop, receiver);
+            if (typeof value === 'function' && typeof prop === 'string' && wrapped.includes(prop)) {
+                const fn = value;
+                return async (...args) => {
+                    try {
+                        return await fn.apply(target, args);
+                    }
+                    catch (error) {
+                        handleError(error, requestId);
+                    }
+                };
+            }
+            return value;
+        },
+    });
+}
+/**
+ * McpBouncer wraps the AdonisJS Bouncer instance and converts
+ * authorization exceptions (`E_AUTHORIZATION_FAILURE`) into
+ * `JsonRpcException` so they are properly serialized as JSON-RPC
+ * error responses instead of leaking HTTP-centric error handling.
+ *
+ * Every public method signature is kept identical to the original
+ * Bouncer class so that consumers get full type-safety.
+ */
+export default class McpBouncer {
+    #bouncer;
+    #requestId;
+    constructor(bouncer, requestId) {
+        this.#bouncer = bouncer;
+        this.#requestId = requestId;
+    }
+    /**
+     * Access the underlying bouncer abilities.
+     */
+    get abilities() {
+        return this.#bouncer.abilities;
+    }
+    /**
+     * Access the underlying bouncer policies.
+     */
+    get policies() {
+        return this.#bouncer.policies;
+    }
+    with(policy) {
+        const authorizer = this.#bouncer.with(policy);
+        return wrapPolicyAuthorizer(authorizer, this.#requestId);
+    }
+    async execute(ability, ...args) {
+        try {
+            return await this.#bouncer.execute(ability, ...args);
+        }
+        catch (error) {
+            handleError(error, this.#requestId);
+        }
+    }
+    async allows(ability, ...args) {
+        try {
+            return await this.#bouncer.allows(ability, ...args);
+        }
+        catch (error) {
+            handleError(error, this.#requestId);
+        }
+    }
+    async denies(action, ...args) {
+        try {
+            return await this.#bouncer.denies(action, ...args);
+        }
+        catch (error) {
+            handleError(error, this.#requestId);
+        }
+    }
+    async authorize(ability, ...args) {
+        try {
+            return await this.#bouncer.authorize(ability, ...args);
+        }
+        catch (error) {
+            handleError(error, this.#requestId);
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // deny()
+    // ---------------------------------------------------------------------------
+    /**
+     * Create AuthorizationResponse to deny access.
+     * This is a pass-through since it doesn't throw.
+     */
+    deny(message, status) {
+        return this.#bouncer.deny(message, status);
+    }
+}

package/build/src/server/transports/http_transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../../src/server/transports/http_transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,SAAS;;gBAIzC,GAAG,EAAE,WAAW;IAK5B,IAAI,SAAS,uBAEZ;IAED,WAAW,CAAC,UAAU,EAAE,UAAU;IAOlC,QAAQ,CAAC,UAAU,EAAE,UAAU;IAO/B,IAAI,CAAC,OAAO,EAAE,eAAe;CAG9B"}
+{"version":3,"file":"http_transport.d.ts","sourceRoot":"","sources":["../../../../src/server/transports/http_transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAI7D,MAAM,CAAC,OAAO,OAAO,aAAc,YAAW,SAAS;;gBAIzC,GAAG,EAAE,WAAW;IAK5B,IAAI,SAAS,uBAEZ;IAED,WAAW,CAAC,UAAU,EAAE,UAAU;IAOlC,QAAQ,CAAC,UAAU,EAAE,UAAU;IAM/B,IAAI,CAAC,OAAO,EAAE,eAAe;CAG9B"}

package/build/src/server/transports/http_transport.js

@@ -4,6 +4,7 @@
  * @license MIT
  * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
  */
+import McpBouncer from '../mcp_bouncer.js';
 export default class HttpTransport {
     #ctx;
     #sessionId;
@@ -16,13 +17,13 @@ export default class HttpTransport {
     }
     bindBouncer(mcpContext) {
         if ('bouncer' in this.#ctx) {
-            // @ts-ignore
-            mcpContext.bouncer = this.#ctx.bouncer;
+            const bouncer = this.#ctx.bouncer;
+            mcpContext.bouncer = new McpBouncer(bouncer, mcpContext.request.id);
         }
     }
     bindAuth(mcpContext) {
         if ('auth' in this.#ctx) {
-            // @ts-ignore
+            ;
             mcpContext.auth = this.#ctx.auth;
         }
     }

package/build/src/server.d.ts

@@ -8,7 +8,12 @@ import type { McpConfig } from './types/config.js';
 import type { JsonRpcRequest } from './types/jsonrpc.js';
 import type { ToolList, ResourceList, PromptList } from './types/method.js';
 import type { Transport } from './server/contracts/transport.js';
+import type { LoggerService, EmitterService } from '@adonisjs/core/types';
 import ServerContext from './server/context.js';
+type Services = {
+    logger: LoggerService;
+    emitter: EmitterService;
+};
 export default class Server {
     #private;
     config: McpConfig;
@@ -35,7 +40,7 @@ export default class Server {
         'completion/complete': () => Promise<typeof import("./server/methods/completion.js")>;
         ping: () => Promise<typeof import("./server/methods/ping.js")>;
     };
-    constructor(config: McpConfig);
+    constructor(config: McpConfig, services?: Services);
     addCapability(key: string, value?: boolean): void;
     addTool(item: ToolList): void;
     addResource(item: ResourceList): void;
@@ -45,4 +50,5 @@ export default class Server {
     handle(jsonRequest: JsonRpcRequest): Promise<void | null>;
     createContext(jsonRpcRequest: JsonRpcRequest): ServerContext;
 }
+export {};
 //# sourceMappingURL=server.d.ts.map

package/build/src/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EAEX,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAIhE,OAAO,aAAa,MAAM,qBAAqB,CAAA;AAG/C,MAAM,CAAC,OAAO,OAAO,MAAM;;IAGzB,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,MAAM,CAAwB;IACpC,OAAO,EAAE,MAAM,CAAU;IACzB,YAAY,EAAE,MAAM,CAA2E;IAE/F,wBAAwB,EAAE,MAAM,EAAE,CAA+B;IAEjE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAUhC;IAED,KAAK,EAAE,QAAQ,CAAK;IACpB,SAAS,EAAE,YAAY,CAAK;IAC5B,iBAAiB,EAAE,YAAY,CAAK;IACpC,OAAO,EAAE,UAAU,CAAK;IAExB,mBAAmB,EAAE,MAAM,CAAK;IAChC,uBAAuB,EAAE,MAAM,CAAK;IAEpC,OAAO;;;;;;;;;;;MAWN;gBAEW,MAAM,EAAE,SAAS;IA4B7B,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc;IAchD,OAAO,CAAC,IAAI,EAAE,QAAQ;IAGtB,WAAW,CAAC,IAAI,EAAE,YAAY;IAG9B,mBAAmB,CAAC,IAAI,EAAE,YAAY;IAGtC,SAAS,CAAC,IAAI,EAAE,UAAU;IAIpB,OAAO,CAAC,SAAS,EAAE,SAAS;IAI5B,MAAM,CAAC,WAAW,EAAE,cAAc;IA6CxC,aAAa,CAAC,cAAc,EAAE,cAAc;CAgB7C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,UAAU,EAEX,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAIzE,OAAO,aAAa,MAAM,qBAAqB,CAAA;AAG/C,KAAK,QAAQ,GAAG;IACd,MAAM,EAAE,aAAa,CAAA;IACrB,OAAO,EAAE,cAAc,CAAA;CACxB,CAAA;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;IAKzB,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,MAAM,CAAwB;IACpC,OAAO,EAAE,MAAM,CAAU;IACzB,YAAY,EAAE,MAAM,CAA2E;IAE/F,wBAAwB,EAAE,MAAM,EAAE,CAA+B;IAEjE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAUhC;IAED,KAAK,EAAE,QAAQ,CAAK;IACpB,SAAS,EAAE,YAAY,CAAK;IAC5B,iBAAiB,EAAE,YAAY,CAAK;IACpC,OAAO,EAAE,UAAU,CAAK;IAExB,mBAAmB,EAAE,MAAM,CAAK;IAChC,uBAAuB,EAAE,MAAM,CAAK;IAEpC,OAAO;;;;;;;;;;;MAWN;gBAEW,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,QAAQ;IA+BlD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc;IAchD,OAAO,CAAC,IAAI,EAAE,QAAQ;IAGtB,WAAW,CAAC,IAAI,EAAE,YAAY;IAG9B,mBAAmB,CAAC,IAAI,EAAE,YAAY;IAGtC,SAAS,CAAC,IAAI,EAAE,UAAU;IAIpB,OAAO,CAAC,SAAS,EAAE,SAAS;IAI5B,MAAM,CAAC,WAAW,EAAE,cAAc;IAyDxC,aAAa,CAAC,cAAc,EAAE,cAAc;CAgB7C"}

package/build/src/server.js

@@ -9,6 +9,8 @@ import { ErrorCode } from './enums/error.js';
 import ServerContext from './server/context.js';
 import JsonRpcException from './server/exceptions/jsonrpc_exception.js';
 export default class Server {
+    #logger;
+    #emitter;
     #transport;
     config;
     name = 'AdonisJS MCP Server';
@@ -44,7 +46,7 @@ export default class Server {
         'completion/complete': () => import('./server/methods/completion.js'),
         'ping': () => import('./server/methods/ping.js'),
     };
-    constructor(config) {
+    constructor(config, services) {
         this.config = config;
         if (config.name) {
             this.name = config.name;
@@ -64,6 +66,8 @@ export default class Server {
         if (config.completions) {
             this.addCapability('completions');
         }
+        this.#logger = services?.logger;
+        this.#emitter = services?.emitter;
     }
     addCapability(key, value = true) {
         if (key.includes('.')) {
@@ -91,6 +95,7 @@ export default class Server {
         this.#transport = transport;
     }
     async handle(jsonRequest) {
+        this.#emitter?.emit('mcp:request', jsonRequest);
         // INGORE NOTIFICATIONS FOR NOW
         if (jsonRequest.method.startsWith('notifications/')) {
             return null;
@@ -111,19 +116,31 @@ export default class Server {
                 const instance = new MethodClass();
                 // Ensure the instance is treated as MethodInterface when calling handle to satisfy TS
                 const response = await instance.handle(mcpContext);
+                this.#emitter?.emit('mcp:response', response);
                 this.#transport.send(response);
             }
             else {
-                throw new JsonRpcException(`The method ${jsonRequest.method} was not found.`, ErrorCode.MethodNotFound, jsonRequest.id);
+                const jsonRpcException = new JsonRpcException(`The method ${jsonRequest.method} was not found.`, ErrorCode.MethodNotFound, jsonRequest.id);
+                throw jsonRpcException;
             }
         }
         catch (error) {
+            let response;
             if (error instanceof JsonRpcException) {
-                return this.#transport.send(error.toJsonRpcResponse());
+                response = error.toJsonRpcResponse();
+                this.#logger?.error(response, error.message);
             }
-            return this.#transport.send(new JsonRpcException('Internal error', ErrorCode.InternalError, jsonRequest.id, {
-                error,
-            }).toJsonRpcResponse());
+            else {
+                response = new JsonRpcException('Internal error', ErrorCode.InternalError, jsonRequest.id, {
+                    error: {
+                        name: error.name,
+                        message: error.message,
+                    },
+                }).toJsonRpcResponse();
+                this.#logger?.error(error);
+            }
+            this.#emitter?.emit('mcp:response', response);
+            return this.#transport.send(response);
         }
     }
     createContext(jsonRpcRequest) {

package/build/stubs/make/mcp/prompts/main.ts.stub

@@ -24,7 +24,7 @@ export default class {{ className }} extends Prompt<Schema> {
   async handle({ args, response }: PromptContext<Schema>) {
     return [
       response.text('Hello, world!'),
-      response.text(args?.text)
+      response.text(args?.text!)
     ]
   }
 

package/build/stubs/make/mcp/prompts/with_vine.ts.stub

@@ -0,0 +1,40 @@
+{{#var className = `${name}Prompt`}}
+{{#var promptName = string(name).snakeCase()}}
+{{#var resourceFileName = string(className).snakeCase().ext('.ts').toString()}}
+{{{
+  exports({
+    to: app.makePath(app.rcFile.directories['mcp'] || 'app/mcp/', `prompts/`, resourceFileName)
+  })
+}}}
+import type { PromptContext } from '@jrmc/adonis-mcp/types/context'
+import type { BaseSchema } from '@jrmc/adonis-mcp/types/method'
+
+import { Prompt } from '@jrmc/adonis-mcp'
+import vine from '@vinejs/vine'
+
+type Schema = BaseSchema<{
+  text: { type: "string" }
+}>
+
+const vineSchema = vine.object({
+  text: vine.string().meta({
+    description: 'Description text argument',
+  }),
+})
+
+export default class {{ className }} extends Prompt<Schema> {
+  name = '{{ promptName }}'
+  title = 'Prompt title'
+  description = 'Prompt description'
+
+  async handle({ args, response }: PromptContext<Schema>) {
+    return [
+      response.text('Hello, world!'),
+      response.text(args?.text!)
+    ]
+  }
+
+  schema() {
+    return vine.create(vineSchema).toJSONSchema() as Schema
+  }
+}