@razroo/code-validation-mcp-client 1.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2013-present Pagar.me Pagamentos S/A
+
+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,271 @@
+# Razroo Code Validation MCP Client
+
+**Local bridge between Claude Code and Razroo HTTP API**
+
+## What This Does
+
+This is a small MCP client that:
+1. Runs locally on your machine
+2. Connects to Claude Code via stdio (MCP protocol)
+3. Forwards requests to Razroo's hosted HTTP API
+4. Returns results back to Claude Code
+
+```
+Claude Code (your machine)
+    ↕ stdio (MCP protocol)
+MCP Client Bridge (this tool)
+    ↕ HTTPS (REST API)
+Razroo API Server (AWS Lambda)
+    ↕
+Razroo's data (Qdrant, DynamoDB, S3)
+```
+
+## Installation
+
+### NPM Package (Recommended)
+
+```bash
+npm install -g @razroo/code-validation-mcp-client
+```
+
+### From Source
+
+```bash
+git clone https://github.com/razroo/code-validation-client
+cd code-validation-client
+npm install
+npm run build
+npm link
+```
+
+## Configuration
+
+### 1. Get Your API Key & URL
+
+You need these from Razroo:
+- **API Key**: `rzr_abc123...` (Razroo generates this for you)
+- **API URL**: `https://xyz.execute-api.us-east-1.amazonaws.com/prod`
+
+### 2. Configure Claude Code
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "razroo-code-validation": {
+      "command": "razroo-mcp-client",
+      "env": {
+        "RAZROO_API_KEY": "rzr_your_api_key_here",
+        "RAZROO_API_URL": "https://your-api-url.amazonaws.com/prod"
+      }
+    }
+  }
+}
+```
+
+**Or if installed from source:**
+
+```json
+{
+  "mcpServers": {
+    "razroo-code-validation": {
+      "command": "node",
+      "args": ["/absolute/path/to/code-validation-client/dist/index.js"],
+      "env": {
+        "RAZROO_API_KEY": "rzr_your_api_key_here",
+        "RAZROO_API_URL": "https://your-api-url.amazonaws.com/prod"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Claude Code
+
+Close and reopen Claude Code completely.
+
+## Usage
+
+Once configured, Claude Code will automatically use the tools:
+
+### Example 1: Search for Similar Code
+
+```
+You: I'm adding authentication to my Angular app. Can you search for similar patterns?
+
+Claude: [Automatically calls search_similar_code]
+I found several matching patterns! The top match is "Add Authentication" with 92% similarity.
+This recipe has 4 steps:
+1. Create Auth Service
+2. Add Auth Guard
+3. Update Routing
+4. Create Login Component
+
+Let me help you implement each step...
+```
+
+### Example 2: Get Recipe Steps
+
+```
+You: Show me all the steps for the authentication recipe
+
+Claude: [Calls get_recipe_steps]
+Here are all 4 steps in the "Add Authentication" recipe:
+
+Step 1: Create Auth Service
+- Files: auth.service.ts, auth.service.spec.ts
+[Shows code]
+
+Step 2: Add Auth Guard
+- Files: auth.guard.ts, auth.guard.spec.ts
+[Shows code]
+
+...
+```
+
+### Example 3: Validate Generated Code
+
+```
+You: I just generated an auth service. Can you validate it against known patterns?
+
+[You paste your code]
+
+Claude: [Calls search_similar_code with your code]
+Your code has 88% similarity to the "Add Authentication" pattern.
+It looks good! Here are a few suggestions based on the pattern:
+1. Add error handling for login failures
+2. Include token refresh logic
+3. Add logout method
+...
+```
+
+## Available Tools
+
+### 1. `search_similar_code`
+
+Search for similar code patterns.
+
+**Input:**
+- `code` (required): Code snippet to search
+- `framework` (optional): Filter by framework
+- `language` (optional): Filter by language
+- `operationType` (optional): Filter by operation type
+- `limit` (optional): Number of results (default: 10)
+
+**Output:** Array of matching patterns with scores
+
+### 2. `get_recipe_steps`
+
+Get all steps for a recipe.
+
+**Input:**
+- `orgId` (required): Organization ID (usually "community")
+- `pathId` (required): Path/workspace ID
+- `recipeId` (required): Recipe ID
+
+**Output:** Array of steps with code files
+
+### 3. `get_step_code_files`
+
+Get code files for a specific step.
+
+**Input:**
+- `orgId` (required): Organization ID
+- `pathId` (required): Path/workspace ID
+- `recipeId` (required): Recipe ID
+- `stepId` (required): Step ID
+
+**Output:** Array of code files with content
+
+## Troubleshooting
+
+### "RAZROO_API_KEY is required"
+
+**Problem:** API key not set
+
+**Fix:** Add `RAZROO_API_KEY` to your Claude Code config (see Configuration above)
+
+### "401 Unauthorized"
+
+**Problem:** Invalid API key
+
+**Fix:**
+1. Check your API key is correct
+2. Verify key is active (not revoked)
+3. Contact Razroo support if needed
+
+### "429 Too Many Requests"
+
+**Problem:** Rate limit exceeded
+
+**Fix:**
+1. Wait 1 minute for rate limit to reset
+2. Upgrade to higher tier if needed
+3. Reduce frequency of requests
+
+### Tools Not Appearing in Claude Code
+
+**Problem:** Claude Code doesn't see the tools
+
+**Fix:**
+1. Verify config file location: `~/.claude/claude_desktop_config.json`
+2. Check for JSON syntax errors
+3. Ensure absolute paths (not relative)
+4. Restart Claude Code completely
+
+### "Command not found: razroo-mcp-client"
+
+**Problem:** NPM package not installed globally
+
+**Fix:**
+```bash
+# If installed from source
+cd code-validation-client
+npm link
+
+# Or use absolute path in config instead
+```
+
+## Development
+
+### Run Locally
+
+```bash
+npm run build
+RAZROO_API_KEY=rzr_your_key RAZROO_API_URL=https://your-api npm start
+```
+
+### Test with MCP Inspector
+
+```bash
+npx @modelcontextprotocol/inspector \
+  node dist/index.js \
+  --env RAZROO_API_KEY=rzr_your_key \
+  --env RAZROO_API_URL=https://your-api
+```
+
+## What Users Need
+
+✅ **API Key** - Get from Razroo
+✅ **API URL** - Get from Razroo
+✅ **This client** - Install via NPM
+✅ **Claude Code** - Already installed
+
+That's it! No AWS credentials, no Qdrant setup, no infrastructure.
+
+## Cost
+
+**For users:** FREE (client runs locally)
+
+**For Razroo:** Usage charged based on API calls (your pricing model)
+
+## Support
+
+- Installation help: See README
+- API issues: Contact Razroo support
+- Feature requests: [GitHub Issues](https://github.com/razroo/code-validation-client/issues)
+
+## License
+
+MIT

package/dist/index.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+/**
+ * Razroo Code Validation MCP Client
+ *
+ * Bridges Claude Code (stdio) to Razroo HTTP API
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+// Get config from environment
+const API_KEY = process.env.RAZROO_API_KEY;
+const API_URL = process.env.RAZROO_API_URL;
+if (!API_KEY) {
+    console.error('Error: RAZROO_API_KEY environment variable is required');
+    process.exit(1);
+}
+if (!API_URL) {
+    console.error('Error: RAZROO_API_URL environment variable is required');
+    process.exit(1);
+}
+// Tool definitions
+const TOOLS = [
+    {
+        name: 'search_similar_code',
+        description: 'Search for similar code patterns from Razroo recipe library. Returns top matches with similarity scores.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                code: {
+                    type: 'string',
+                    description: 'The code snippet to search for similar patterns',
+                },
+                framework: {
+                    type: 'string',
+                    description: 'Optional: Filter by framework (e.g., "angular", "react", "vue")',
+                },
+                language: {
+                    type: 'string',
+                    description: 'Optional: Filter by language (e.g., "typescript", "javascript", "python")',
+                },
+                operationType: {
+                    type: 'string',
+                    enum: ['add', 'modify', 'delete'],
+                    description: 'Optional: Filter by operation type',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Number of results to return (default: 10, max: 50)',
+                    default: 10,
+                },
+            },
+            required: ['code'],
+        },
+    },
+    {
+        name: 'get_recipe_steps',
+        description: 'Get all steps for a specific recipe. Use this after finding a match to see the complete implementation pattern.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                orgId: {
+                    type: 'string',
+                    description: 'Organization ID (typically "community" for public recipes)',
+                },
+                pathId: {
+                    type: 'string',
+                    description: 'Path/workspace ID (e.g., "angular-17.0.0")',
+                },
+                recipeId: {
+                    type: 'string',
+                    description: 'Recipe ID (e.g., "add-authentication")',
+                },
+            },
+            required: ['orgId', 'pathId', 'recipeId'],
+        },
+    },
+    {
+        name: 'get_step_code_files',
+        description: 'Get code files for a specific step in a recipe. Use this to see the actual code for a particular step.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                orgId: {
+                    type: 'string',
+                    description: 'Organization ID',
+                },
+                pathId: {
+                    type: 'string',
+                    description: 'Path/workspace ID',
+                },
+                recipeId: {
+                    type: 'string',
+                    description: 'Recipe ID',
+                },
+                stepId: {
+                    type: 'string',
+                    description: 'Step ID (e.g., "step-1")',
+                },
+            },
+            required: ['orgId', 'pathId', 'recipeId', 'stepId'],
+        },
+    },
+];
+// HTTP client helper
+async function callAPI(endpoint, body) {
+    const url = `${API_URL}${endpoint}`;
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Authorization': API_KEY,
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`API error (${response.status}): ${error}`);
+    }
+    const data = await response.json();
+    if (!data.success) {
+        throw new Error(`API returned error: ${JSON.stringify(data)}`);
+    }
+    return data.data;
+}
+// Create MCP server
+const server = new Server({
+    name: 'razroo-code-validation',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handle tool list requests
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: TOOLS,
+    };
+});
+// Handle tool execution
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'search_similar_code': {
+                const data = await callAPI('/api/v1/mcp/search-similar-code', args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_recipe_steps': {
+                const data = await callAPI('/api/v1/mcp/get-recipe-steps', args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            case 'get_step_code_files': {
+                const data = await callAPI('/api/v1/mcp/get-step-code-files', args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(data, null, 2),
+                        },
+                    ],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${errorMessage}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start server
+async function main() {
+    console.error('Razroo Code Validation MCP Client starting...');
+    console.error(`API URL: ${API_URL}`);
+    console.error(`API Key: ${API_KEY?.substring(0, 8)}...`);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('MCP Client ready');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@razroo/code-validation-mcp-client",
+  "version": "1.0.0",
+  "description": "MCP client bridge for Razroo Code Validation API",
+  "type": "module",
+  "bin": {
+    "razroo-mcp-client": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rm -rf ./dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  },
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "razroo",
+    "code-validation",
+    "ai-code-generation",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/razroo/code-validation-client.git"
+  },
+  "homepage": "https://github.com/razroo/code-validation-client#readme",
+  "bugs": {
+    "url": "https://github.com/razroo/code-validation-client/issues"
+  },
+  "author": "Razroo",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}