@veloxts/mcp 0.6.23

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 VeloxTS Framework Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * VeloxTS MCP Server CLI
+ *
+ * Run the MCP server with stdio transport for integration with AI tools.
+ *
+ * @example
+ * ```bash
+ * # Run MCP server
+ * velox-mcp
+ *
+ * # Run with debug output
+ * velox-mcp --debug
+ * ```
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG"}

package/dist/bin.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * VeloxTS MCP Server CLI
+ *
+ * Run the MCP server with stdio transport for integration with AI tools.
+ *
+ * @example
+ * ```bash
+ * # Run MCP server
+ * velox-mcp
+ *
+ * # Run with debug output
+ * velox-mcp --debug
+ * ```
+ */
+import { runMCPServer } from './server.js';
+// Parse command line arguments
+const args = process.argv.slice(2);
+const debug = args.includes('--debug') || args.includes('-d');
+// Run the server
+runMCPServer({ debug }).catch((error) => {
+    console.error('Failed to start MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,+BAA+B;AAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAE9D,iBAAiB;AACjB,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACtC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @veloxts/mcp - Model Context Protocol Server for VeloxTS
+ *
+ * Exposes VeloxTS project context to AI tools via the Model Context Protocol.
+ * This enables AI assistants like Claude to introspect procedures, schemas,
+ * routes, and error codes programmatically.
+ *
+ * @example
+ * ```typescript
+ * import { createVeloxMCPServer, runMCPServer } from '@veloxts/mcp';
+ *
+ * // Run with stdio transport (for CLI integration)
+ * await runMCPServer({ debug: true });
+ *
+ * // Or create a server instance for custom integration
+ * const server = createVeloxMCPServer({
+ *   projectRoot: '/path/to/project',
+ *   debug: true,
+ * });
+ * ```
+ *
+ * @module @veloxts/mcp
+ */
+export type { VeloxMCPServerOptions } from './server.js';
+export { createVeloxMCPServer, runMCPServer } from './server.js';
+export type { ErrorInfo, ErrorsResourceResponse, ProcedureInfo, ProceduresResourceResponse, RouteInfo, RoutesResourceResponse, SchemaInfo, SchemasResourceResponse, } from './resources/index.js';
+export { formatErrorsAsText, formatProceduresAsText, formatRoutesAsText, formatSchemasAsText, getErrors, getErrorsByPrefix, getProcedures, getProceduresByNamespace, getProceduresByType, getRoutes, getRoutesByMethod, getRoutesByNamespace, getSchemas, searchErrors, searchSchemas, } from './resources/index.js';
+export type { GenerateOptions, GenerateResult, GeneratorType, MigrateAction, MigrateOptions, MigrateResult, MigrationInfo, } from './tools/index.js';
+export { formatGenerateResult, formatMigrateResult, generate, generateProcedure, generateResource, generateSchema, migrate, migrateFresh, migrateReset, migrateRollback, migrateRun, migrateStatus, } from './tools/index.js';
+export type { PromptArgument, PromptTemplate } from './prompts/index.js';
+export { ADD_VALIDATION, CREATE_PROCEDURE, ERROR_HANDLING, getPromptTemplate, listPromptTemplates, PROMPT_TEMPLATES, renderPromptTemplate, SETUP_AUTH, } from './prompts/index.js';
+export type { ProjectInfo } from './utils/project.js';
+export { findProjectRoot, getProceduresPath, getProjectInfo, getSchemasPath, isVeloxProject, } from './utils/project.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMjE,YAAY,EACV,SAAS,EACT,sBAAsB,EACtB,aAAa,EACb,0BAA0B,EAC1B,SAAS,EACT,sBAAsB,EACtB,UAAU,EACV,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAC;AAM9B,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,kBAAkB,CAAC;AAM1B,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAM5B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * @veloxts/mcp - Model Context Protocol Server for VeloxTS
+ *
+ * Exposes VeloxTS project context to AI tools via the Model Context Protocol.
+ * This enables AI assistants like Claude to introspect procedures, schemas,
+ * routes, and error codes programmatically.
+ *
+ * @example
+ * ```typescript
+ * import { createVeloxMCPServer, runMCPServer } from '@veloxts/mcp';
+ *
+ * // Run with stdio transport (for CLI integration)
+ * await runMCPServer({ debug: true });
+ *
+ * // Or create a server instance for custom integration
+ * const server = createVeloxMCPServer({
+ *   projectRoot: '/path/to/project',
+ *   debug: true,
+ * });
+ * ```
+ *
+ * @module @veloxts/mcp
+ */
+export { createVeloxMCPServer, runMCPServer } from './server.js';
+export { formatErrorsAsText, formatProceduresAsText, formatRoutesAsText, formatSchemasAsText, getErrors, getErrorsByPrefix, getProcedures, getProceduresByNamespace, getProceduresByType, getRoutes, getRoutesByMethod, getRoutesByNamespace, getSchemas, searchErrors, searchSchemas, } from './resources/index.js';
+export { formatGenerateResult, formatMigrateResult, generate, generateProcedure, generateResource, generateSchema, migrate, migrateFresh, migrateReset, migrateRollback, migrateRun, migrateStatus, } from './tools/index.js';
+export { ADD_VALIDATION, CREATE_PROCEDURE, ERROR_HANDLING, getPromptTemplate, listPromptTemplates, PROMPT_TEMPLATES, renderPromptTemplate, SETUP_AUTH, } from './prompts/index.js';
+export { findProjectRoot, getProceduresPath, getProjectInfo, getSchemasPath, isVeloxProject, } from './utils/project.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAOH,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgBjE,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAC;AAe9B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,kBAAkB,CAAC;AAO1B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,oBAAoB,CAAC;AAO5B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Prompts
+ *
+ * Reusable prompt templates for AI assistants.
+ */
+export type { PromptArgument, PromptTemplate } from './templates.js';
+export { ADD_VALIDATION, CREATE_PROCEDURE, ERROR_HANDLING, getPromptTemplate, listPromptTemplates, PROMPT_TEMPLATES, renderPromptTemplate, SETUP_AUTH, } from './templates.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,7 @@
+/**
+ * MCP Prompts
+ *
+ * Reusable prompt templates for AI assistants.
+ */
+export { ADD_VALIDATION, CREATE_PROCEDURE, ERROR_HANDLING, getPromptTemplate, listPromptTemplates, PROMPT_TEMPLATES, renderPromptTemplate, SETUP_AUTH, } from './templates.js';
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,gBAAgB,CAAC"}

package/dist/prompts/templates.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Prompt Templates
+ *
+ * Reusable prompt templates for common VeloxTS tasks.
+ */
+/**
+ * Prompt template definition
+ */
+export interface PromptTemplate {
+    /** Unique identifier for the prompt */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Template arguments */
+    arguments?: PromptArgument[];
+    /** The prompt content */
+    content: string;
+}
+/**
+ * Prompt argument definition
+ */
+export interface PromptArgument {
+    /** Argument name */
+    name: string;
+    /** Argument description */
+    description: string;
+    /** Whether the argument is required */
+    required?: boolean;
+}
+/**
+ * Create procedure template
+ */
+export declare const CREATE_PROCEDURE: PromptTemplate;
+/**
+ * Add validation template
+ */
+export declare const ADD_VALIDATION: PromptTemplate;
+/**
+ * Setup authentication template
+ */
+export declare const SETUP_AUTH: PromptTemplate;
+/**
+ * Error handling template
+ */
+export declare const ERROR_HANDLING: PromptTemplate;
+/**
+ * All available prompt templates
+ */
+export declare const PROMPT_TEMPLATES: PromptTemplate[];
+/**
+ * Get a prompt template by name
+ */
+export declare function getPromptTemplate(name: string): PromptTemplate | undefined;
+/**
+ * Render a prompt template with argument substitution
+ *
+ * Supports the following placeholder transformations:
+ * - {arg} - lowercase (e.g., "user")
+ * - {Arg} - PascalCase (e.g., "User")
+ * - {args} - lowercase plural (e.g., "users")
+ * - {Args} - PascalCase plural (e.g., "Users")
+ *
+ * @param name - Template name
+ * @param args - Argument values as key-value pairs
+ * @returns Rendered content or undefined if template not found
+ */
+export declare function renderPromptTemplate(name: string, args: Record<string, string>): string | undefined;
+/**
+ * List all available prompts
+ */
+export declare function listPromptTemplates(): {
+    name: string;
+    description: string;
+}[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/prompts/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cA+E9B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAkF5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,cA6FxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,cAwF5B,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAK5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,MAAM,GAAG,SAAS,CAuCpB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,CAK7E"}