adonis-mcp-docs 0.1.0

package/README.md

@@ -0,0 +1,209 @@
+# Adonis MCP Documentation Server
+
+MCP (Model Context Protocol) server to access adonis-mcp documentation.
+
+## 📋 Resources
+
+### `file:///{name}.md` - Documentation Markdown File
+Resource template to retrieve markdown documentation files from the GitHub repository.
+
+**Available files:**
+- `inspector` - MCP Inspector tool documentation
+- `installation` - Installation guide
+- `introduction` - Introduction to MCP
+- `prompts` - Prompts documentation
+- `resources` - Resources documentation
+- `sessions` - Session management
+- `tools` - Tools documentation
+- `unit-tests` - Unit testing
+
+**Usage example:**
+```
+file:///resources.md
+file:///tools.md
+```
+
+## 🛠️ Tools
+
+### 1. `list_documentation`
+Lists all available documentation files with their descriptions.
+
+**Parameters:** None
+
+**Returns:** Structured list of all available documentation files
+
+**Annotations:**
+- `@isReadOnly()` - Read-only
+- `@isIdempotent()` - Can be called multiple times without side effects
+
+### 2. `search_in_docs`
+Search for a keyword or phrase across all documentation files.
+
+**Parameters:**
+- `query` (string, required) - The keyword or phrase to search for
+- `caseSensitive` (boolean, optional) - Case-sensitive search (default: false)
+
+**Returns:** List of matches with context (2 lines before/after)
+
+**Annotations:**
+- `@isReadOnly()` - Read-only
+- `@isOpenWorld()` - Accesses external resources (GitHub)
+- `@isIdempotent()` - Can be called multiple times without side effects
+
+**Example:**
+```json
+{
+  "query": "Resource templates",
+  "caseSensitive": false
+}
+```
+
+### 3. `extract_code_examples`
+Extracts all code blocks from a documentation file with their languages and line numbers.
+
+**Parameters:**
+- `filename` (string, required) - File name (without .md extension)
+
+**Returns:** Structured list of all code blocks with their language, content, and line number
+
+**Annotations:**
+- `@isReadOnly()` - Read-only
+- `@isOpenWorld()` - Accesses external resources (GitHub)
+- `@isIdempotent()` - Can be called multiple times without side effects
+
+**Example:**
+```json
+{
+  "filename": "resources"
+}
+```
+
+## 🎯 Prompts
+
+### `explain_feature`
+Guide to get a detailed explanation of an adonis-mcp feature with code examples.
+
+**Parameters:**
+- `feature` (string, required) - The feature to explain
+- `level` (string, optional) - Audience level: "beginner", "intermediate", "advanced" (default: "intermediate")
+
+**Suggested features:**
+- resources
+- tools
+- prompts
+- resource templates
+- tool annotations
+- completions
+- authentication
+- authorization
+- sessions
+- unit testing
+- inspector
+- middleware
+
+**Example:**
+```json
+{
+  "feature": "resource templates",
+  "level": "intermediate"
+}
+```
+
+## 🚀 Usage
+
+### Installation
+
+Install globally via npm:
+```bash
+npm install -g adonis-mcp-docs
+```
+
+Or use with npx (no installation required):
+```bash
+npx adonis-mcp-docs
+```
+
+### Testing locally before publishing
+
+1. Build the project:
+```bash
+npm run build
+```
+
+2. Test with npx locally:
+```bash
+cd build
+node bin/mcp.js
+```
+
+### Start the MCP server
+
+```bash
+adonis-mcp-docs
+```
+
+Or with npx:
+```bash
+npx adonis-mcp-docs
+```
+
+### Configuration for MCP Clients
+
+Add to your Claude Desktop or Cursor MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "adonis-mcp-docs": {
+      "command": "npx",
+      "args": ["adonis-mcp-docs"]
+    }
+  }
+}
+```
+
+## 📦 Services
+
+### `DocumentationService`
+Manages retrieval of remote markdown files from GitHub.
+
+**Methods:**
+- `fetchMarkdownFile(name: string)` - Fetches a markdown file
+- `fileExists(name: string)` - Checks if a file exists
+- `getFileSize(name: string)` - Gets the size of a file
+
+### `ResourceCompletionService`
+Provides completion suggestions for documentation file names.
+
+**Methods:**
+- `getCompletions(prefix?: string)` - Returns files matching the prefix
+- `getAllNames()` - Returns all available file names
+
+## 🔍 Combined Usage Examples
+
+### Search then read
+1. Use `search_in_docs` to find where a concept is documented
+2. Use the `file:///{name}.md` resource to read the complete content
+
+### Extract and analyze
+1. Use `extract_code_examples` to get all examples
+2. Analyze the code with a custom prompt
+
+### Explore then explain
+1. Use `list_documentation` to see what's available
+2. Use the `explain_feature` prompt to get a detailed explanation
+
+## 📝 Technical Notes
+
+- **Base URL:** `https://raw.githubusercontent.com/batosai/adonis-mcp/main/docs`
+- **Format:** Markdown (`.md`)
+- **Search:** Case-insensitive by default with 2 lines of context
+- **Parsing:** Code block extraction with automatic language detection
+
+## 🎨 Advanced Features
+
+- ✅ Completions enabled for all templates
+- ✅ Tool annotations to guide AI
+- ✅ Robust error handling
+- ✅ Search with context
+- ✅ Automatic extraction of all code blocks with language detection

package/build/.env

@@ -0,0 +1,6 @@
+TZ=UTC
+PORT=3333
+HOST=localhost
+LOG_LEVEL=info
+APP_KEY=M64hR7knLLQ2vQnOf8JG4l01fek9lPXm
+NODE_ENV=production

package/build/ace.js

@@ -0,0 +1,7 @@
+/**
+ * This file is auto-generated by the build process.
+ * If you had any custom code inside this file, then
+ * instead write it inside the "bin/console.js" file.
+ */
+
+await import('./bin/console.js')

package/build/adonisrc.js

@@ -0,0 +1,34 @@
+import { defineConfig } from '@adonisjs/core/app';
+export default defineConfig({
+    experimental: {
+        mergeMultipartFieldsAndFiles: true,
+        shutdownInReverseOrder: true,
+    },
+    commands: [() => import('@adonisjs/core/commands'), () => import('@jrmc/adonis-mcp/commands')],
+    providers: [
+        () => import('@adonisjs/core/providers/app_provider'),
+        () => import('@adonisjs/core/providers/hash_provider'),
+        {
+            file: () => import('@adonisjs/core/providers/repl_provider'),
+            environment: ['repl', 'test'],
+        },
+        () => import('@jrmc/adonis-mcp/mcp_provider')
+    ],
+    preloads: [() => import('#start/routes'), () => import('#start/kernel')],
+    tests: {
+        suites: [
+            {
+                files: ['tests/unit/**/*.spec(.ts|.js)'],
+                name: 'unit',
+                timeout: 2000,
+            },
+            {
+                files: ['tests/functional/**/*.spec(.ts|.js)'],
+                name: 'functional',
+                timeout: 30000,
+            },
+        ],
+        forceExit: false,
+    },
+});
+//# sourceMappingURL=adonisrc.js.map

package/build/adonisrc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adonisrc.js","sourceRoot":"","sources":["../adonisrc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,eAAe,YAAY,CAAC;IAW1B,YAAY,EAAE;QACZ,4BAA4B,EAAE,IAAI;QAClC,sBAAsB,EAAE,IAAI;KAC7B;IAWD,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,yBAAyB,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAW9F,SAAS,EAAE;QACT,GAAG,EAAE,CAAC,MAAM,CAAC,uCAAuC,CAAC;QACrD,GAAG,EAAE,CAAC,MAAM,CAAC,wCAAwC,CAAC;QACtD;YACE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,wCAAwC,CAAC;YAC5D,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;SAC9B;QACD,GAAG,EAAE,CAAC,MAAM,CAAC,+BAA+B,CAAC;KAC9C;IAUD,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAWxE,KAAK,EAAE;QACL,MAAM,EAAE;YACN;gBACE,KAAK,EAAE,CAAC,+BAA+B,CAAC;gBACxC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,IAAI;aACd;YACD;gBACE,KAAK,EAAE,CAAC,qCAAqC,CAAC;gBAC9C,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,KAAK;aACf;SACF;QACD,SAAS,EAAE,KAAK;KACjB;CACF,CAAC,CAAA"}

package/build/app/exceptions/handler.js

@@ -0,0 +1,13 @@
+import app from '@adonisjs/core/services/app';
+import { ExceptionHandler } from '@adonisjs/core/http';
+export default class HttpExceptionHandler extends ExceptionHandler {
+    debug = !app.inProduction;
+    renderStatusPages = app.inProduction;
+    async handle(error, ctx) {
+        return super.handle(error, ctx);
+    }
+    async report(error, ctx) {
+        return super.report(error, ctx);
+    }
+}
+//# sourceMappingURL=handler.js.map

package/build/app/exceptions/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../app/exceptions/handler.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,6BAA6B,CAAA;AAC7C,OAAO,EAAe,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEnE,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,gBAAgB;IAKtD,KAAK,GAAG,CAAC,GAAG,CAAC,YAAY,CAAA;IAOzB,iBAAiB,GAAG,GAAG,CAAC,YAAY,CAAA;IAM9C,KAAK,CAAC,MAAM,CAAC,KAAc,EAAE,GAAgB;QAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACjC,CAAC;IAQD,KAAK,CAAC,MAAM,CAAC,KAAc,EAAE,GAAgB;QAC3C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IACjC,CAAC;CACF"}

package/build/app/mcp/prompts/explain_feature_prompt.js

@@ -0,0 +1,73 @@
+import { Prompt } from '@jrmc/adonis-mcp';
+export default class ExplainFeaturePrompt extends Prompt {
+    name = 'explain_feature';
+    title = 'Explain Documentation Feature';
+    description = 'Get a detailed explanation of an adonis-mcp feature with code examples and best practices';
+    async handle({ args, response }) {
+        const feature = args?.feature;
+        const level = args?.level || 'intermediate';
+        return [
+            response.text(`Please explain the "${feature}" feature in adonis-mcp in detail.`),
+            response.text(`Target audience level: ${level}`),
+            response.text(''),
+            response.text('Include the following in your explanation:'),
+            response.text('1. **Overview**: What is this feature and why is it useful?'),
+            response.text('2. **How it works**: Explain the core concepts and mechanics'),
+            response.text('3. **Code Examples**: Provide practical, working code examples'),
+            response.text('4. **Common Use Cases**: When and why to use this feature'),
+            response.text('5. **Best Practices**: Tips for effective implementation'),
+            response.text('6. **Common Pitfalls**: What to avoid and potential issues'),
+            response.text('7. **Related Features**: Other features that work well with this'),
+            response.text(''),
+            response.embeddedResource('file:///resources.md'),
+            response.embeddedResource('file:///tools.md'),
+            response.embeddedResource('file:///prompts.md'),
+            response.text(''),
+            response.text('Use the embedded documentation resources above as reference.')
+        ];
+    }
+    async complete({ args, response }) {
+        const typedArgs = args;
+        if (typedArgs?.feature !== undefined) {
+            return response.complete({
+                values: [
+                    'resources',
+                    'tools',
+                    'prompts',
+                    'resource templates',
+                    'tool annotations',
+                    'completions',
+                    'authentication',
+                    'authorization',
+                    'sessions',
+                    'unit testing',
+                    'inspector',
+                    'middleware'
+                ]
+            });
+        }
+        if (typedArgs?.level !== undefined) {
+            return response.complete({
+                values: ['beginner', 'intermediate', 'advanced']
+            });
+        }
+        return response.complete({ values: [] });
+    }
+    schema() {
+        return {
+            type: 'object',
+            properties: {
+                feature: {
+                    type: 'string',
+                    description: 'The feature or concept to explain (e.g., "resources", "tools", "prompts", "authentication")'
+                },
+                level: {
+                    type: 'string',
+                    description: 'Target audience level: beginner, intermediate, or advanced (default: intermediate)'
+                }
+            },
+            required: ['feature']
+        };
+    }
+}
+//# sourceMappingURL=explain_feature_prompt.js.map

package/build/app/mcp/prompts/explain_feature_prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain_feature_prompt.js","sourceRoot":"","sources":["../../../../app/mcp/prompts/explain_feature_prompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAUzC,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,MAAc;IAC9D,IAAI,GAAG,iBAAiB,CAAA;IACxB,KAAK,GAAG,+BAA+B,CAAA;IACvC,WAAW,GAAG,2FAA2F,CAAA;IAEzG,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAyB;QACpD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAA;QAC7B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,cAAc,CAAA;QAE3C,OAAO;YACL,QAAQ,CAAC,IAAI,CAAC,uBAAuB,OAAO,oCAAoC,CAAC;YACjF,QAAQ,CAAC,IAAI,CAAC,0BAA0B,KAAK,EAAE,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,4CAA4C,CAAC;YAC3D,QAAQ,CAAC,IAAI,CAAC,6DAA6D,CAAC;YAC5E,QAAQ,CAAC,IAAI,CAAC,8DAA8D,CAAC;YAC7E,QAAQ,CAAC,IAAI,CAAC,gEAAgE,CAAC;YAC/E,QAAQ,CAAC,IAAI,CAAC,2DAA2D,CAAC;YAC1E,QAAQ,CAAC,IAAI,CAAC,0DAA0D,CAAC;YACzE,QAAQ,CAAC,IAAI,CAAC,4DAA4D,CAAC;YAC3E,QAAQ,CAAC,IAAI,CAAC,kEAAkE,CAAC;YACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,gBAAgB,CAAC,sBAAsB,CAAC;YACjD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,CAAC;YAC7C,QAAQ,CAAC,gBAAgB,CAAC,oBAAoB,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,8DAA8D,CAAC;SAC9E,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAA2B;QACxD,MAAM,SAAS,GAAG,IAAwD,CAAA;QAG1E,IAAI,SAAS,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,QAAQ,CAAC,QAAQ,CAAC;gBACvB,MAAM,EAAE;oBACN,WAAW;oBACX,OAAO;oBACP,SAAS;oBACT,oBAAoB;oBACpB,kBAAkB;oBAClB,aAAa;oBACb,gBAAgB;oBAChB,eAAe;oBACf,UAAU;oBACV,cAAc;oBACd,WAAW;oBACX,YAAY;iBACb;aACF,CAAC,CAAA;QACJ,CAAC;QAGD,IAAI,SAAS,EAAE,KAAK,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,QAAQ,CAAC,QAAQ,CAAC;gBACvB,MAAM,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,UAAU,CAAC;aACjD,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,6FAA6F;iBAChG;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oFAAoF;iBAClG;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACZ,CAAA;IACb,CAAC;CACF"}

package/build/app/mcp/resources/markdown_resource.js

@@ -0,0 +1,26 @@
+import { Resource } from '@jrmc/adonis-mcp';
+import { DocumentationService } from '#services/documentation_service';
+import { ResourceCompletionService } from '#services/resource_completion_service';
+export default class MarkdownResource extends Resource {
+    name = 'documentation_file';
+    uri = 'file:///{name}.md';
+    mimeType = 'text/markdown';
+    title = 'Documentation Markdown File';
+    description = 'Dynamic resource to access markdown documentation files. Use {name} parameter to specify the file to retrieve.';
+    async handle({ args, response }) {
+        const documentationService = new DocumentationService();
+        const name = args?.name;
+        if (!name) {
+            throw new Error('File name is required');
+        }
+        const content = await documentationService.fetchMarkdownFile(name);
+        this.size = content.length;
+        return response.text(content);
+    }
+    async complete({ args, response }) {
+        const resourceCompletionService = new ResourceCompletionService();
+        const completions = resourceCompletionService.getCompletions(args?.name);
+        return response.complete({ values: completions });
+    }
+}
+//# sourceMappingURL=markdown_resource.js.map

package/build/app/mcp/resources/markdown_resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown_resource.js","sourceRoot":"","sources":["../../../../app/mcp/resources/markdown_resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAA;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAA;AAMjF,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,QAAc;IAC1D,IAAI,GAAG,oBAAoB,CAAA;IAC3B,GAAG,GAAG,mBAAmB,CAAA;IACzB,QAAQ,GAAG,eAAe,CAAA;IAE1B,KAAK,GAAG,6BAA6B,CAAA;IACrC,WAAW,GAAG,gHAAgH,CAAA;IAE9H,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAyB;QACpD,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAA;QACvD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAA;QAEvB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAClE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,MAAM,CAAA;QAE1B,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAyB;QACtD,MAAM,yBAAyB,GAAG,IAAI,yBAAyB,EAAE,CAAA;QACjE,MAAM,WAAW,GAAG,yBAAyB,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACxE,OAAO,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;IACnD,CAAC;CACF"}

package/build/app/mcp/tools/extract_code_examples_tool.js

@@ -0,0 +1,80 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Tool } from '@jrmc/adonis-mcp';
+import { isReadOnly, isOpenWorld, isIdempotent } from '@jrmc/adonis-mcp/tool_annotations';
+import { DocumentationService } from '#services/documentation_service';
+let ExtractCodeExamplesTool = class ExtractCodeExamplesTool extends Tool {
+    name = 'extract_code_examples';
+    title = 'Extract Code Examples';
+    description = 'Extracts all code blocks from a documentation file with their language and line numbers';
+    async handle({ args, response }) {
+        const typedArgs = args;
+        const filename = typedArgs?.filename;
+        if (!filename || filename.trim() === '') {
+            return response.error('Filename is required');
+        }
+        const documentationService = new DocumentationService();
+        try {
+            const content = await documentationService.fetchMarkdownFile(filename);
+            const codeBlocks = [];
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                const blockStart = line.match(/^```(\w+)?$/);
+                if (blockStart) {
+                    const blockLanguage = blockStart[1] || 'text';
+                    const codeLines = [];
+                    let j = i + 1;
+                    while (j < lines.length && !lines[j].match(/^```$/)) {
+                        codeLines.push(lines[j]);
+                        j++;
+                    }
+                    if (j < lines.length) {
+                        codeBlocks.push({
+                            language: blockLanguage,
+                            code: codeLines.join('\n'),
+                            lineNumber: i + 1
+                        });
+                    }
+                }
+            }
+            if (codeBlocks.length === 0) {
+                return response.text(`No code blocks found in '${filename}'`);
+            }
+            return response.structured({
+                filename: filename,
+                totalBlocks: codeBlocks.length,
+                codeBlocks: codeBlocks
+            });
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return response.error(`Failed to extract code examples: ${error.message}`);
+            }
+            return response.error('Failed to extract code examples from documentation');
+        }
+    }
+    schema() {
+        return {
+            type: 'object',
+            properties: {
+                filename: {
+                    type: 'string',
+                    description: 'Name of the documentation file (without .md extension, e.g., "resources", "tools")'
+                }
+            },
+            required: ['filename']
+        };
+    }
+};
+ExtractCodeExamplesTool = __decorate([
+    isReadOnly(),
+    isOpenWorld(),
+    isIdempotent()
+], ExtractCodeExamplesTool);
+export default ExtractCodeExamplesTool;
+//# sourceMappingURL=extract_code_examples_tool.js.map

package/build/app/mcp/tools/extract_code_examples_tool.js.map

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

package/build/app/mcp/tools/list_documentation_tool.js

@@ -0,0 +1,59 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Tool } from '@jrmc/adonis-mcp';
+import { isReadOnly, isIdempotent } from '@jrmc/adonis-mcp/tool_annotations';
+let ListDocumentationTool = class ListDocumentationTool extends Tool {
+    name = 'list_documentation';
+    title = 'List Documentation Files';
+    description = 'Lists all available documentation markdown files with their names and descriptions';
+    async handle({ response }) {
+        const documentationFiles = [
+            {
+                name: 'inspector',
+                description: 'Documentation about the MCP Inspector tool for debugging and testing'
+            },
+            {
+                name: 'installation',
+                description: 'Installation guide for setting up adonis-mcp in your project'
+            },
+            {
+                name: 'introduction',
+                description: 'Introduction to the Model Context Protocol (MCP) and adonis-mcp'
+            },
+            {
+                name: 'prompts',
+                description: 'Guide on creating and using prompts in your MCP server'
+            },
+            {
+                name: 'resources',
+                description: 'Documentation about MCP resources and how to create them'
+            },
+            {
+                name: 'sessions',
+                description: 'Information about session management in MCP'
+            },
+            {
+                name: 'tools',
+                description: 'Guide on creating and implementing tools in your MCP server'
+            },
+            {
+                name: 'unit-tests',
+                description: 'Documentation on writing unit tests for your MCP components'
+            }
+        ];
+        return response.structured({
+            total: documentationFiles.length,
+            files: documentationFiles
+        });
+    }
+};
+ListDocumentationTool = __decorate([
+    isReadOnly(),
+    isIdempotent()
+], ListDocumentationTool);
+export default ListDocumentationTool;
+//# sourceMappingURL=list_documentation_tool.js.map

package/build/app/mcp/tools/list_documentation_tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list_documentation_tool.js","sourceRoot":"","sources":["../../../../app/mcp/tools/list_documentation_tool.ts"],"names":[],"mappings":";;;;;;AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAA;AAO7D,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,IAAI;IACrD,IAAI,GAAG,oBAAoB,CAAA;IAC3B,KAAK,GAAG,0BAA0B,CAAA;IAClC,WAAW,GAAG,oFAAoF,CAAA;IAElG,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAe;QACpC,MAAM,kBAAkB,GAAG;YACzB;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,sEAAsE;aACpF;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,8DAA8D;aAC5E;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,iEAAiE;aAC/E;YACD;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wDAAwD;aACtE;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,0DAA0D;aACxE;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,6CAA6C;aAC3D;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,6DAA6D;aAC3E;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,6DAA6D;aAC3E;SACF,CAAA;QAED,OAAO,QAAQ,CAAC,UAAU,CAAC;YACzB,KAAK,EAAE,kBAAkB,CAAC,MAAM;YAChC,KAAK,EAAE,kBAAkB;SAC1B,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AA9CoB,qBAAqB;IAFzC,UAAU,EAAE;IACZ,YAAY,EAAE;GACM,qBAAqB,CA8CzC;eA9CoB,qBAAqB"}

package/build/app/mcp/tools/search_in_docs_tool.js

@@ -0,0 +1,96 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Tool } from '@jrmc/adonis-mcp';
+import { isReadOnly, isOpenWorld, isIdempotent } from '@jrmc/adonis-mcp/tool_annotations';
+import { DocumentationService } from '#services/documentation_service';
+let SearchInDocsTool = class SearchInDocsTool extends Tool {
+    name = 'search_in_docs';
+    title = 'Search in Documentation';
+    description = 'Search for a keyword or phrase across all documentation files and return matching sections';
+    async handle({ args, response }) {
+        const query = args?.query;
+        const caseSensitive = args?.caseSensitive ?? false;
+        if (!query || query.trim() === '') {
+            return response.error('Search query is required');
+        }
+        const documentationService = new DocumentationService();
+        const fileNames = [
+            'inspector',
+            'installation',
+            'introduction',
+            'prompts',
+            'resources',
+            'sessions',
+            'tools',
+            'unit-tests'
+        ];
+        const results = [];
+        for (const fileName of fileNames) {
+            try {
+                const content = await documentationService.fetchMarkdownFile(fileName);
+                const lines = content.split('\n');
+                const matches = [];
+                const searchQuery = caseSensitive ? query : query.toLowerCase();
+                lines.forEach((line, index) => {
+                    const searchLine = caseSensitive ? line : line.toLowerCase();
+                    if (searchLine.includes(searchQuery)) {
+                        const contextBefore = lines.slice(Math.max(0, index - 2), index);
+                        const contextAfter = lines.slice(index + 1, Math.min(lines.length, index + 3));
+                        matches.push({
+                            lineNumber: index + 1,
+                            line: line.trim(),
+                            context: [...contextBefore, ...contextAfter].map(l => l.trim())
+                        });
+                    }
+                });
+                if (matches.length > 0) {
+                    results.push({
+                        file: fileName,
+                        matches: matches
+                    });
+                }
+            }
+            catch (error) {
+                continue;
+            }
+        }
+        if (results.length === 0) {
+            return response.text(`No results found for query: "${query}"`);
+        }
+        const totalMatches = results.reduce((sum, result) => sum + result.matches.length, 0);
+        return response.structured({
+            query: query,
+            caseSensitive: caseSensitive,
+            totalFiles: results.length,
+            totalMatches: totalMatches,
+            results: results
+        });
+    }
+    schema() {
+        return {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'The search query (keyword or phrase to find in documentation)'
+                },
+                caseSensitive: {
+                    type: 'boolean',
+                    description: 'Whether the search should be case-sensitive (default: false)'
+                }
+            },
+            required: ['query']
+        };
+    }
+};
+SearchInDocsTool = __decorate([
+    isReadOnly(),
+    isOpenWorld(),
+    isIdempotent()
+], SearchInDocsTool);
+export default SearchInDocsTool;
+//# sourceMappingURL=search_in_docs_tool.js.map

package/build/app/mcp/tools/search_in_docs_tool.js.map

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

package/build/app/middleware/container_bindings_middleware.js

@@ -0,0 +1,10 @@
+import { Logger } from '@adonisjs/core/logger';
+import { HttpContext } from '@adonisjs/core/http';
+export default class ContainerBindingsMiddleware {
+    handle(ctx, next) {
+        ctx.containerResolver.bindValue(HttpContext, ctx);
+        ctx.containerResolver.bindValue(Logger, ctx.logger);
+        return next();
+    }
+}
+//# sourceMappingURL=container_bindings_middleware.js.map

package/build/app/middleware/container_bindings_middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container_bindings_middleware.js","sourceRoot":"","sources":["../../../app/middleware/container_bindings_middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAUjD,MAAM,CAAC,OAAO,OAAO,2BAA2B;IAC9C,MAAM,CAAC,GAAgB,EAAE,IAAY;QACnC,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;QACjD,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;QAEnD,OAAO,IAAI,EAAE,CAAA;IACf,CAAC;CACF"}