@mbc-cqrs-serverless/mcp-server 1.0.15

package/LICENSE.txt

@@ -0,0 +1,7 @@
+Copyright 2024 Murakami Business Consulting, Inc. https://www.mbc-net.com/
+
+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/README.md

@@ -0,0 +1,196 @@
+# @mbc-cqrs-serverless/mcp-server
+
+MCP (Model Context Protocol) server for MBC CQRS Serverless framework. This package enables AI tools like Claude Code, Cursor, and other MCP-compatible clients to interact with the framework.
+
+## Features
+
+### Resources
+
+Access framework documentation and project information:
+
+| Resource URI | Description |
+|--------------|-------------|
+| `mbc://docs/overview` | Complete framework documentation |
+| `mbc://docs/llms-short` | Concise framework summary |
+| `mbc://docs/architecture` | CQRS architecture guide |
+| `mbc://docs/errors` | Error catalog with solutions |
+| `mbc://docs/faq` | Frequently asked questions |
+| `mbc://docs/troubleshooting` | Troubleshooting guide |
+| `mbc://docs/security` | Security best practices |
+| `mbc://project/entities` | List of project entities |
+| `mbc://project/modules` | List of project modules |
+| `mbc://project/structure` | Project directory structure |
+
+### Tools
+
+Generate code and analyze projects:
+
+| Tool | Description |
+|------|-------------|
+| `mbc_generate_module` | Generate a complete CQRS module |
+| `mbc_generate_controller` | Generate a controller |
+| `mbc_generate_service` | Generate a service |
+| `mbc_generate_entity` | Generate an entity |
+| `mbc_generate_dto` | Generate a DTO |
+| `mbc_validate_cqrs` | Validate CQRS pattern implementation |
+| `mbc_analyze_project` | Analyze project structure |
+| `mbc_lookup_error` | Look up error solutions |
+
+### Prompts
+
+Get guided assistance:
+
+| Prompt | Description |
+|--------|-------------|
+| `cqrs_implementation_guide` | Step-by-step CQRS implementation |
+| `debug_command_error` | Debug command-related errors |
+| `migration_guide` | Version migration guidance |
+
+## Installation
+
+```bash
+npm install @mbc-cqrs-serverless/mcp-server
+```
+
+Or use directly with npx:
+
+```bash
+npx @mbc-cqrs-serverless/mcp-server
+```
+
+## Configuration
+
+### Claude Code
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "mbc-cqrs-serverless": {
+      "command": "npx",
+      "args": ["@mbc-cqrs-serverless/mcp-server"],
+      "env": {
+        "MBC_PROJECT_PATH": "/path/to/your/project"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to Cursor's MCP settings:
+
+```json
+{
+  "mbc-cqrs-serverless": {
+    "command": "npx",
+    "args": ["@mbc-cqrs-serverless/mcp-server"],
+    "env": {
+      "MBC_PROJECT_PATH": "/path/to/your/project"
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `MBC_PROJECT_PATH` | Path to the project directory | Current working directory |
+
+## Usage Examples
+
+### With Claude Code
+
+Once configured, you can ask Claude Code to:
+
+```
+"Generate a new Order module with async command handling"
+```
+
+Claude Code will use the `mbc_generate_module` tool to create the module.
+
+```
+"Analyze my project structure"
+```
+
+Claude Code will use the `mbc_analyze_project` tool to provide insights.
+
+```
+"I'm getting a version mismatch error, help me debug"
+```
+
+Claude Code will use the `debug_command_error` prompt and `mbc_lookup_error` tool.
+
+### Resource Access
+
+AI tools can access framework documentation:
+
+```
+Read mbc://docs/errors to understand common errors
+```
+
+### Code Generation
+
+```
+Use mbc_generate_module to create a Product module with sync mode
+```
+
+### Project Analysis
+
+```
+Run mbc_validate_cqrs to check my CQRS implementation
+```
+
+## Development
+
+### Building
+
+```bash
+cd packages/mcp-server
+npm install
+npm run build
+```
+
+### Testing
+
+```bash
+# Run the server locally
+npm start
+
+# Or with a specific project path
+MBC_PROJECT_PATH=/path/to/project npm start
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  AI Tools (Claude Code, Cursor, etc.)                       │
+│                         │                                    │
+│                    MCP Protocol (stdio)                      │
+│                         ↓                                    │
+│  ┌───────────────────────────────────────────────────────┐  │
+│  │  @mbc-cqrs-serverless/mcp-server                      │  │
+│  │                                                        │  │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌──────────────┐  │  │
+│  │  │  Resources  │  │    Tools    │  │   Prompts    │  │  │
+│  │  │             │  │             │  │              │  │  │
+│  │  │ - docs      │  │ - generate  │  │ - cqrs_guide │  │  │
+│  │  │ - project   │  │ - validate  │  │ - debug      │  │  │
+│  │  │ - errors    │  │ - analyze   │  │ - migration  │  │  │
+│  │  └─────────────┘  └─────────────┘  └──────────────┘  │  │
+│  └───────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## License
+
+MIT
+
+## Related Packages
+
+- [@mbc-cqrs-serverless/core](../core) - Core CQRS framework
+- [@mbc-cqrs-serverless/cli](../cli) - CLI tool for code generation

package/bin/mcp-server.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+/**
+ * MCP Server executable for MBC CQRS Serverless framework.
+ *
+ * Usage:
+ *   npx @mbc-cqrs-serverless/mcp-server
+ *
+ * Environment Variables:
+ *   MBC_PROJECT_PATH - Path to the project directory (defaults to cwd)
+ */
+
+require('../dist/index.js')

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = require("./server.js");
+/**
+ * MCP Server for MBC CQRS Serverless framework.
+ *
+ * This server provides:
+ * - Resources: Framework documentation, error catalog, project info
+ * - Tools: Code generation, validation, analysis
+ * - Prompts: CQRS implementation guides, debugging help
+ *
+ * @example
+ * // Run the server
+ * npx @mbc-cqrs-serverless/mcp-server
+ *
+ * // Configure in Claude Code
+ * // Add to ~/.claude/claude_desktop_config.json:
+ * {
+ *   "mcpServers": {
+ *     "mbc-cqrs-serverless": {
+ *       "command": "npx",
+ *       "args": ["@mbc-cqrs-serverless/mcp-server"],
+ *       "env": {
+ *         "MBC_PROJECT_PATH": "/path/to/your/project"
+ *       }
+ *     }
+ *   }
+ * }
+ */
+// Global error handlers
+process.on('uncaughtException', (error) => {
+    console.error('[Uncaught Exception]', error);
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason, promise) => {
+    console.error('[Unhandled Rejection]', reason);
+});
+async function main() {
+    try {
+        const server = new server_js_1.McpServer();
+        await server.run();
+    }
+    catch (error) {
+        console.error('[Fatal Error]', error);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,2CAAuC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,wBAAwB;AACxB,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAA;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACjB,CAAC,CAAC,CAAA;AAEF,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE;IACnD,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAA;AAChD,CAAC,CAAC,CAAA;AAEF,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,qBAAS,EAAE,CAAA;QAC9B,MAAM,MAAM,CAAC,GAAG,EAAE,CAAA;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAA"}

package/dist/prompts/cqrs-guide.d.ts

@@ -0,0 +1,8 @@
+import { Prompt, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * CQRS implementation guide prompts.
+ */
+export declare function getCqrsPrompts(): Prompt[];
+export declare function getCqrsPromptMessages(name: string, args: Record<string, string>): {
+    messages: PromptMessage[];
+};