@jrmc/adonis-mcp 1.0.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (119) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +292 -0
  3. package/build/commands/commands.json +1 -0
  4. package/build/commands/main.d.ts +4 -0
  5. package/build/commands/main.js +36 -0
  6. package/build/commands/make/tool.d.ts +16 -0
  7. package/build/commands/make/tool.d.ts.map +1 -0
  8. package/build/commands/make/tool.js +35 -0
  9. package/build/commands/start.d.ts +16 -0
  10. package/build/commands/start.d.ts.map +1 -0
  11. package/build/commands/start.js +30 -0
  12. package/build/configure.d.ts +9 -0
  13. package/build/configure.d.ts.map +1 -0
  14. package/build/configure.js +21 -0
  15. package/build/index.d.ts +5 -0
  16. package/build/index.d.ts.map +1 -0
  17. package/build/index.js +4 -0
  18. package/build/providers/mcp_provider.d.ts +27 -0
  19. package/build/providers/mcp_provider.d.ts.map +1 -0
  20. package/build/providers/mcp_provider.js +48 -0
  21. package/build/src/define_config.d.ts +9 -0
  22. package/build/src/define_config.d.ts.map +1 -0
  23. package/build/src/define_config.js +12 -0
  24. package/build/src/enums/error.d.ts +16 -0
  25. package/build/src/enums/error.d.ts.map +1 -0
  26. package/build/src/enums/error.js +18 -0
  27. package/build/src/enums/role.d.ts +12 -0
  28. package/build/src/enums/role.d.ts.map +1 -0
  29. package/build/src/enums/role.js +12 -0
  30. package/build/src/request.d.ts +18 -0
  31. package/build/src/request.d.ts.map +1 -0
  32. package/build/src/request.js +12 -0
  33. package/build/src/response.d.ts +32 -0
  34. package/build/src/response.d.ts.map +1 -0
  35. package/build/src/response.js +33 -0
  36. package/build/src/server/context.d.ts +27 -0
  37. package/build/src/server/context.d.ts.map +1 -0
  38. package/build/src/server/context.js +33 -0
  39. package/build/src/server/controllers/mcp_controller.d.ts +11 -0
  40. package/build/src/server/controllers/mcp_controller.d.ts.map +1 -0
  41. package/build/src/server/controllers/mcp_controller.js +15 -0
  42. package/build/src/server/exceptions/jsonrpc_exception.d.ts +9 -0
  43. package/build/src/server/exceptions/jsonrpc_exception.d.ts.map +1 -0
  44. package/build/src/server/exceptions/jsonrpc_exception.js +22 -0
  45. package/build/src/server/methods/call_tool.d.ts +12 -0
  46. package/build/src/server/methods/call_tool.d.ts.map +1 -0
  47. package/build/src/server/methods/call_tool.js +40 -0
  48. package/build/src/server/methods/get_prompt.d.ts +12 -0
  49. package/build/src/server/methods/get_prompt.d.ts.map +1 -0
  50. package/build/src/server/methods/get_prompt.js +12 -0
  51. package/build/src/server/methods/initialize.d.ts +12 -0
  52. package/build/src/server/methods/initialize.d.ts.map +1 -0
  53. package/build/src/server/methods/initialize.js +31 -0
  54. package/build/src/server/methods/list_prompts.d.ts +12 -0
  55. package/build/src/server/methods/list_prompts.d.ts.map +1 -0
  56. package/build/src/server/methods/list_prompts.js +13 -0
  57. package/build/src/server/methods/list_resources.d.ts +12 -0
  58. package/build/src/server/methods/list_resources.d.ts.map +1 -0
  59. package/build/src/server/methods/list_resources.js +13 -0
  60. package/build/src/server/methods/list_tools.d.ts +12 -0
  61. package/build/src/server/methods/list_tools.d.ts.map +1 -0
  62. package/build/src/server/methods/list_tools.js +46 -0
  63. package/build/src/server/methods/ping.d.ts +12 -0
  64. package/build/src/server/methods/ping.d.ts.map +1 -0
  65. package/build/src/server/methods/ping.js +12 -0
  66. package/build/src/server/methods/read_resource.d.ts +12 -0
  67. package/build/src/server/methods/read_resource.d.ts.map +1 -0
  68. package/build/src/server/methods/read_resource.js +12 -0
  69. package/build/src/server/pagination/cursor_paginator.d.ts +12 -0
  70. package/build/src/server/pagination/cursor_paginator.d.ts.map +1 -0
  71. package/build/src/server/pagination/cursor_paginator.js +45 -0
  72. package/build/src/server/tool.d.ts +18 -0
  73. package/build/src/server/tool.d.ts.map +1 -0
  74. package/build/src/server/tool.js +8 -0
  75. package/build/src/server/transports/fake_transport.d.ts +20 -0
  76. package/build/src/server/transports/fake_transport.d.ts.map +1 -0
  77. package/build/src/server/transports/fake_transport.js +28 -0
  78. package/build/src/server/transports/http_transport.d.ts +18 -0
  79. package/build/src/server/transports/http_transport.d.ts.map +1 -0
  80. package/build/src/server/transports/http_transport.js +27 -0
  81. package/build/src/server/transports/stdio_transport.d.ts +17 -0
  82. package/build/src/server/transports/stdio_transport.d.ts.map +1 -0
  83. package/build/src/server/transports/stdio_transport.js +39 -0
  84. package/build/src/server.d.ts +45 -0
  85. package/build/src/server.d.ts.map +1 -0
  86. package/build/src/server.js +132 -0
  87. package/build/src/types/config.d.ts +15 -0
  88. package/build/src/types/config.d.ts.map +1 -0
  89. package/build/src/types/config.js +7 -0
  90. package/build/src/types/context.d.ts +28 -0
  91. package/build/src/types/context.d.ts.map +1 -0
  92. package/build/src/types/context.js +7 -0
  93. package/build/src/types/method.d.ts +37 -0
  94. package/build/src/types/method.d.ts.map +1 -0
  95. package/build/src/types/method.js +7 -0
  96. package/build/src/types/notification.d.ts +14 -0
  97. package/build/src/types/notification.d.ts.map +1 -0
  98. package/build/src/types/notification.js +7 -0
  99. package/build/src/types/request.d.ts +44 -0
  100. package/build/src/types/request.d.ts.map +1 -0
  101. package/build/src/types/request.js +7 -0
  102. package/build/src/types/response.d.ts +46 -0
  103. package/build/src/types/response.d.ts.map +1 -0
  104. package/build/src/types/response.js +7 -0
  105. package/build/src/types/transport.d.ts +14 -0
  106. package/build/src/types/transport.d.ts.map +1 -0
  107. package/build/src/types/transport.js +7 -0
  108. package/build/src/utils/stdio.d.ts +20 -0
  109. package/build/src/utils/stdio.d.ts.map +1 -0
  110. package/build/src/utils/stdio.js +36 -0
  111. package/build/stubs/config.ts.stub +10 -0
  112. package/build/stubs/main.d.ts +2 -0
  113. package/build/stubs/main.d.ts.map +1 -0
  114. package/build/stubs/main.js +2 -0
  115. package/build/stubs/make/mcp/prompts/main.ts.stub +27 -0
  116. package/build/stubs/make/mcp/resources/main.ts.stub +29 -0
  117. package/build/stubs/make/mcp/tools/main.ts.stub +41 -0
  118. package/build/tsconfig.tsbuildinfo +1 -0
  119. package/package.json +65 -0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Jeremy Chaufourier
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,292 @@
1
+ # @jrmc/adonis-mcp
2
+
3
+ [![npm version](https://badge.fury.io/js/%40jrmc%2Fadonis-mcp.svg)](https://badge.fury.io/js/%40jrmc%2Fadonis-mcp)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
+
6
+ AdonisJS MCP - Server MCP for your AdonisJS applications.
7
+
8
+ ## Roadmap
9
+
10
+ - [x] MCP prompts support
11
+ - [ ] MCP resources support
12
+ - [ ] MCP prompts support
13
+ - [ ] Alternative transports support SSE
14
+ - [x] Alternative transports support stdio
15
+ - [x] Advanced pagination support
16
+ - [ ] Automatic schema validation with Vine ??
17
+ - [ ] Fake transport
18
+ - [ ] Documentation
19
+
20
+ ## Installation & Configuration
21
+
22
+ ```bash
23
+ node ace add @jrmc/adonis-mcp
24
+ ```
25
+
26
+ This will create a configuration file `config/mcp.ts`:
27
+
28
+ ```typescript
29
+ import { defineConfig } from '@jrmc/adonis-mcp'
30
+
31
+ export default defineConfig({
32
+ name: 'adonis-mcp-server',
33
+ version: '1.0.0',
34
+ path: 'app/mcp', // Path where your tools will be stored
35
+ })
36
+ ```
37
+
38
+ ## Usage
39
+
40
+ ### Creating a Tool
41
+
42
+ To create a new tool, use the Ace command:
43
+
44
+ ```bash
45
+ node ace make:mcp-tool my_tool
46
+ ```
47
+
48
+ This command will create a file in `app/mcp/tools/my_tool.ts` with a base template:
49
+
50
+ ```typescript
51
+ import type { McpContext } from '@jrmc/adonis-mcp/types/context'
52
+ import type { BaseSchema, InferJSONSchema } from '@jrmc/adonis-mcp/types/method'
53
+
54
+ import { Tool } from '@jrmc/adonis-mcp'
55
+
56
+ type Schema = BaseSchema<{
57
+ text: { type: "string" }
58
+ }>
59
+
60
+ type Context = McpContext & { args: InferJSONSchema<Schema> }
61
+
62
+ export default class MyToolTool implements Tool<Schema> {
63
+ name = 'tool_name'
64
+ title = 'Tool title'
65
+ description = 'Tool description'
66
+
67
+ async handle({ args }: Context) {
68
+ console.log(args.text)
69
+ }
70
+
71
+ schema() {
72
+ return {
73
+ type: "object",
74
+ properties: {
75
+ text: {
76
+ type: "string",
77
+ description: "Description text argument"
78
+ },
79
+ },
80
+ required: ["text"]
81
+ } as Schema
82
+ }
83
+ }
84
+ ```
85
+
86
+ ### Schema Definition
87
+
88
+ The schema defines the input parameters of your tool. It follows the [JSON Schema](https://json-schema.org/) specification:
89
+
90
+ ```typescript
91
+ schema() {
92
+ return {
93
+ type: "object",
94
+ properties: {
95
+ title: {
96
+ type: "string",
97
+ description: "Bookmark title"
98
+ },
99
+ url: {
100
+ type: "string",
101
+ description: "Bookmark URL"
102
+ }
103
+ },
104
+ required: ["title", "url"]
105
+ } as Schema
106
+ }
107
+ ```
108
+
109
+ You can also use Zod to define your schema:
110
+
111
+ ```typescript
112
+ import * as z from 'zod'
113
+
114
+ const zodSchema = z.object({
115
+ page: z.number().optional(),
116
+ perPage: z.number().optional()
117
+ })
118
+
119
+ schema() {
120
+ return z.toJSONSchema(
121
+ zodSchema,
122
+ { io: "input" }
123
+ ) as Schema
124
+ }
125
+ ```
126
+
127
+ ### Handler Implementation
128
+
129
+ The `handle` method contains your tool's logic. It receives a typed context with validated arguments:
130
+
131
+ ```typescript
132
+ async handle({ args, response, auth, bouncer }: Context) {
133
+ // Your logic here
134
+ const result = await SomeModel.query().where('id', args.id)
135
+
136
+ return response.text(JSON.stringify({ result }))
137
+ }
138
+ ```
139
+
140
+ ### Setting up Authentication and Bouncer
141
+
142
+ To use `auth` and `bouncer` in your MCP tools, add the following TypeScript declaration in your middleware (e.g., in your Bouncer initialization middleware):
143
+
144
+ ```typescript
145
+ declare module '@jrmc/adonis-mcp/types/context' {
146
+ export interface McpContext {
147
+ auth?: {
148
+ user?: HttpContext['auth']['user']
149
+ }
150
+ bouncer?: Bouncer<
151
+ Exclude<HttpContext['auth']['user'], undefined>,
152
+ typeof abilities,
153
+ typeof policies
154
+ >
155
+ }
156
+ }
157
+ ```
158
+
159
+ The MCP context automatically binds `auth` and `bouncer` from the `HttpContext` if they are available, so make sure your middleware initializes them on the `HttpContext` first.
160
+
161
+ #### Registering the MCP Route
162
+
163
+ In your `start/routes.ts` file, register the MCP route and apply middleware:
164
+
165
+ ```typescript
166
+ import { middleware } from '#start/kernel'
167
+ import router from '@adonisjs/core/services/router'
168
+
169
+ // Register MCP route (defaults to /mcp, or specify a custom path)
170
+ router.mcp().use(middleware.auth())
171
+ ```
172
+
173
+ You can also specify a custom path:
174
+
175
+ ```typescript
176
+ router.mcp('/custom-mcp-path').use(middleware.auth())
177
+ ```
178
+
179
+ ### Using Authentication
180
+
181
+ The MCP context automatically includes the `auth` instance from the `HttpContext` if available. You can use it to access the authenticated user:
182
+
183
+ ```typescript
184
+ async handle({ args, auth }: Context) {
185
+ const user = auth?.user
186
+
187
+ if (!user) {
188
+ throw new Error('User not authenticated')
189
+ }
190
+
191
+ // Use the authenticated user
192
+ const bookmark = await Bookmark.create({
193
+ title: args.title,
194
+ userId: user.id,
195
+ })
196
+
197
+ return response.text(JSON.stringify({ bookmark }))
198
+ }
199
+ ```
200
+
201
+ ### Using Bouncer
202
+
203
+ The MCP context automatically includes the `bouncer` instance from the `HttpContext` if available. You can use it to check permissions:
204
+
205
+ ```typescript
206
+ async handle({ args, bouncer }: Context) {
207
+ // Check a permission
208
+ await bouncer.authorize('viewUsers')
209
+
210
+ // Or use a policy
211
+ const user = await User.findOrFail(args.userId)
212
+ await bouncer.with(UserPolicy).authorize('view', user)
213
+
214
+ return response.text(JSON.stringify({ user }))
215
+ }
216
+ ```
217
+
218
+ ### Response Return
219
+
220
+ The context includes a `response` instance to format your responses. The most common method is `text()`:
221
+
222
+ ```typescript
223
+ async handle({ args, response }: Context) {
224
+ const data = { success: true, message: 'Operation completed' }
225
+
226
+ return response.text(JSON.stringify(data))
227
+ }
228
+ ```
229
+
230
+ ### Complete Example
231
+
232
+ Here is a complete example of a tool that creates a bookmark:
233
+
234
+ ```typescript
235
+ import type { McpContext } from '@jrmc/adonis-mcp/types/context'
236
+ import type { BaseSchema, InferJSONSchema } from '@jrmc/adonis-mcp/types/method'
237
+
238
+ import { Tool } from '@jrmc/adonis-mcp'
239
+ import Bookmark from '#models/bookmark'
240
+
241
+ type Schema = BaseSchema<{
242
+ title: { type: "string" }
243
+ url: { type: "string" }
244
+ }>
245
+
246
+ type Context = McpContext & { args: InferJSONSchema<Schema> }
247
+
248
+ export default class AddBookmarkTool implements Tool<Schema> {
249
+ name = 'create_bookmark'
250
+ title = 'Create Bookmark'
251
+ description = 'Create a new bookmark'
252
+
253
+ async handle({ args, response, auth }: Context) {
254
+ const bookmark = await Bookmark.create({
255
+ title: args.title,
256
+ text: args.url,
257
+ userId: auth?.user?.id,
258
+ })
259
+
260
+ return response.text(JSON.stringify({ bookmark }))
261
+ }
262
+
263
+ schema() {
264
+ return {
265
+ type: "object",
266
+ properties: {
267
+ title: {
268
+ type: "string",
269
+ description: "Bookmark title"
270
+ },
271
+ url: {
272
+ type: "string",
273
+ description: "Bookmark URL"
274
+ }
275
+ },
276
+ required: ["title", "url"]
277
+ } as Schema
278
+ }
279
+ }
280
+ ```
281
+
282
+ ### Pagination
283
+
284
+ The `tools/list` method supports cursor-based pagination to handle large numbers of tools efficiently. This is particularly useful when you have many tools registered in your application. [More information](https://modelcontextprotocol.io/specification/2025-06-18/server/utilities/pagination)
285
+
286
+ ## Support
287
+
288
+ For any questions or issues, please open an issue on the [GitHub repository](https://github.com/batosai/adonis-mcp).
289
+
290
+ ## Inspiration
291
+
292
+ This package is inspired by [laravel/mcp](https://github.com/laravel/mcp).
@@ -0,0 +1 @@
1
+ {"commands":[{"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}
@@ -0,0 +1,4 @@
1
+ import { CommandMetaData, Command } from '@adonisjs/ace/types';
2
+
3
+ export function getMetaData(): Promise<CommandMetaData[]>
4
+ export function getCommand(metaData: CommandMetaData): Promise<Command | null>
@@ -0,0 +1,36 @@
1
+ import { readFile } from 'node:fs/promises'
2
+
3
+ /**
4
+ * In-memory cache of commands after they have been loaded
5
+ */
6
+ let commandsMetaData
7
+
8
+ /**
9
+ * Reads the commands from the "./commands.json" file. Since, the commands.json
10
+ * file is generated automatically, we do not have to validate its contents
11
+ */
12
+ export async function getMetaData() {
13
+ if (commandsMetaData) {
14
+ return commandsMetaData
15
+ }
16
+
17
+ const commandsIndex = await readFile(new URL('./commands.json', import.meta.url), 'utf-8')
18
+ commandsMetaData = JSON.parse(commandsIndex).commands
19
+
20
+ return commandsMetaData
21
+ }
22
+
23
+ /**
24
+ * Imports the command by lookingup its path from the commands
25
+ * metadata
26
+ */
27
+ export async function getCommand(metaData) {
28
+ const commands = await getMetaData()
29
+ const command = commands.find(({ commandName }) => metaData.commandName === commandName)
30
+ if (!command) {
31
+ return null
32
+ }
33
+
34
+ const { default: commandConstructor } = await import(new URL(command.filePath, import.meta.url).href)
35
+ return commandConstructor
36
+ }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ import type { CommandOptions } from '@adonisjs/core/types/ace';
8
+ import { BaseCommand } from '@adonisjs/core/ace';
9
+ export default class MakeTool extends BaseCommand {
10
+ static commandName: string;
11
+ static description: string;
12
+ static options: CommandOptions;
13
+ name: string;
14
+ run(): Promise<void>;
15
+ }
16
+ //# sourceMappingURL=tool.d.ts.map
@@ -0,0 +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;AAG9D,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;CAYV"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
8
+ var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
9
+ if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
10
+ 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;
11
+ return c > 3 && r && Object.defineProperty(target, key, r), r;
12
+ };
13
+ import { args, BaseCommand } from '@adonisjs/core/ace';
14
+ import string from '@adonisjs/core/helpers/string';
15
+ import { stubsRoot } from '../../stubs/main.js';
16
+ export default class MakeTool extends BaseCommand {
17
+ static commandName = 'make:mcp-tool';
18
+ static description = 'Create a new MCP tool';
19
+ static options = {
20
+ startApp: true,
21
+ };
22
+ async run() {
23
+ const config = this.app.config.get('mcp', { path: 'app/mcp' });
24
+ const codemods = await this.createCodemods();
25
+ const stubPath = `make/mcp/tools/main.ts.stub`;
26
+ await codemods.makeUsingStub(stubsRoot, stubPath, {
27
+ name: string.pascalCase(this.name),
28
+ basePath: config.path,
29
+ });
30
+ this.logger.success(`Tool created successfully for: ${this.name}`);
31
+ }
32
+ }
33
+ __decorate([
34
+ args.string({ description: 'Name of the tool' })
35
+ ], MakeTool.prototype, "name", void 0);
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ import type { CommandOptions } from '@adonisjs/core/types/ace';
8
+ import { BaseCommand } from '@adonisjs/core/ace';
9
+ export default class MakeTool extends BaseCommand {
10
+ #private;
11
+ static commandName: string;
12
+ static description: string;
13
+ static options: CommandOptions;
14
+ run(): Promise<void>;
15
+ }
16
+ //# sourceMappingURL=start.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../commands/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAKhD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,WAAW;;IAC/C,MAAM,CAAC,WAAW,SAAc;IAChC,MAAM,CAAC,WAAW,SAAyC;IAE3D,MAAM,CAAC,OAAO,EAAE,cAAc,CAG7B;IAIK,GAAG;CAaV"}
@@ -0,0 +1,30 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ import { BaseCommand } from '@adonisjs/core/ace';
8
+ import StdioTransport from '../src/server/transports/stdio_transport.js';
9
+ export default class MakeTool extends BaseCommand {
10
+ static commandName = 'mcp:start';
11
+ static description = 'Start the MCP server stdio transport';
12
+ static options = {
13
+ startApp: true,
14
+ // stayAlive: true,
15
+ };
16
+ #server = null;
17
+ async run() {
18
+ try {
19
+ this.#server = await this.app.container.make('jrmc.mcp');
20
+ const transport = new StdioTransport();
21
+ await this.#server.connect(transport);
22
+ transport.on('mcp:stdio:transport:message', async (message) => {
23
+ await this.#server?.handle(message);
24
+ });
25
+ }
26
+ catch (error) {
27
+ throw error;
28
+ }
29
+ }
30
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ import type Configure from '@adonisjs/core/commands/configure';
8
+ export declare function configure(command: Configure): Promise<void>;
9
+ //# sourceMappingURL=configure.d.ts.map
@@ -0,0 +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,iBAejD"}
@@ -0,0 +1,21 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ import { stubsRoot } from './stubs/main.js';
8
+ export async function configure(command) {
9
+ const codemods = await command.createCodemods();
10
+ /**
11
+ * Create default config file
12
+ */
13
+ await codemods.makeUsingStub(stubsRoot, 'config.ts.stub', {});
14
+ /**
15
+ * Register provider
16
+ */
17
+ await codemods.updateRcFile((rcFile) => {
18
+ rcFile.addProvider('@jrmc/adonis-mcp/mcp_provider');
19
+ rcFile.addCommand('@jrmc/adonis-mcp/commands');
20
+ });
21
+ }
@@ -0,0 +1,5 @@
1
+ export { configure } from './configure.js';
2
+ export { Tool } from './src/server/tool.js';
3
+ export * as McpResponse from './src/response.js';
4
+ export { defineConfig } from './src/define_config.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA"}
package/build/index.js ADDED
@@ -0,0 +1,4 @@
1
+ export { configure } from './configure.js';
2
+ export { Tool } from './src/server/tool.js';
3
+ export * as McpResponse from './src/response.js';
4
+ export { defineConfig } from './src/define_config.js';
@@ -0,0 +1,27 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ import type { ApplicationService } from '@adonisjs/core/types';
8
+ import type { RouteGroup } from '@adonisjs/core/http';
9
+ import McpServer from '../src/server.js';
10
+ export default class McpProvider {
11
+ protected app: ApplicationService;
12
+ constructor(app: ApplicationService);
13
+ register(): void;
14
+ start(): Promise<void>;
15
+ registerTools(): Promise<void>;
16
+ }
17
+ declare module '@adonisjs/core/http' {
18
+ interface Router {
19
+ mcp: (pattern?: string) => RouteGroup;
20
+ }
21
+ }
22
+ declare module '@adonisjs/core/types' {
23
+ interface ContainerBindings {
24
+ 'jrmc.mcp': McpServer;
25
+ }
26
+ }
27
+ //# sourceMappingURL=mcp_provider.d.ts.map
@@ -0,0 +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;AAKrD,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;CA4CpB;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"}
@@ -0,0 +1,48 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ // import type { Tool } from '../src/types.js'
8
+ import { fsReadAll } from '@adonisjs/core/helpers';
9
+ import McpServer from '../src/server.js';
10
+ export default class McpProvider {
11
+ app;
12
+ constructor(app) {
13
+ this.app = app;
14
+ }
15
+ register() {
16
+ this.app.container.singleton('jrmc.mcp', async () => {
17
+ const config = this.app.config.get('mcp', {});
18
+ return new McpServer(config);
19
+ });
20
+ }
21
+ async start() {
22
+ const router = await this.app.container.make('router');
23
+ const McpController = () => import('../src/server/controllers/mcp_controller.js');
24
+ router.mcp = (pattern = '/mcp') => {
25
+ return router.group(() => {
26
+ router.post(pattern, [McpController, 'post']);
27
+ });
28
+ };
29
+ await this.registerTools();
30
+ // await this.registerResources()
31
+ // await this.registerPrompts()
32
+ }
33
+ async registerTools() {
34
+ const server = await this.app.container.make('jrmc.mcp');
35
+ const path = this.app.makePath(server.config.path);
36
+ const files = await fsReadAll(path, {
37
+ filter: (filePath) => filePath.includes('_tool.ts'),
38
+ });
39
+ await Promise.all(files.map(async (file) => {
40
+ const path = this.app.makePath(server.config.path, file);
41
+ const { default: tool } = await import(path);
42
+ const toolInstance = new tool();
43
+ server.addTool({
44
+ [toolInstance.name]: path,
45
+ });
46
+ }));
47
+ }
48
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ import type { McpConfig } from './types/config.js';
8
+ export declare function defineConfig<T extends McpConfig>(config: T): T;
9
+ //# sourceMappingURL=define_config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"define_config.d.ts","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,wBAAgB,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAK9D"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ export function defineConfig(config) {
8
+ if (!config.path) {
9
+ config.path = 'app/mcp';
10
+ }
11
+ return config;
12
+ }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ export declare enum ErrorCode {
8
+ ConnectionClosed = -32000,
9
+ RequestTimeout = -32001,
10
+ ParseError = -32700,
11
+ InvalidRequest = -32600,
12
+ MethodNotFound = -32601,
13
+ InvalidParams = -32602,
14
+ InternalError = -32603
15
+ }
16
+ //# sourceMappingURL=error.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/enums/error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAY,SAAS;IAEnB,gBAAgB,SAAS;IACzB,cAAc,SAAS;IAGvB,UAAU,SAAS;IACnB,cAAc,SAAS;IACvB,cAAc,SAAS;IACvB,aAAa,SAAS;IACtB,aAAa,SAAS;CACvB"}
@@ -0,0 +1,18 @@
1
+ /**
2
+ * @jrmc/adonis-mcp
3
+ *
4
+ * @license MIT
5
+ * @copyright Jeremy Chaufourier <jeremy@chaufourier.fr>
6
+ */
7
+ export var ErrorCode;
8
+ (function (ErrorCode) {
9
+ // SDK error codes
10
+ ErrorCode[ErrorCode["ConnectionClosed"] = -32000] = "ConnectionClosed";
11
+ ErrorCode[ErrorCode["RequestTimeout"] = -32001] = "RequestTimeout";
12
+ // Standard JSON-RPC error codes
13
+ ErrorCode[ErrorCode["ParseError"] = -32700] = "ParseError";
14
+ ErrorCode[ErrorCode["InvalidRequest"] = -32600] = "InvalidRequest";
15
+ ErrorCode[ErrorCode["MethodNotFound"] = -32601] = "MethodNotFound";
16
+ ErrorCode[ErrorCode["InvalidParams"] = -32602] = "InvalidParams";
17
+ ErrorCode[ErrorCode["InternalError"] = -32603] = "InternalError";
18
+ })(ErrorCode || (ErrorCode = {}));