@codesherlock/codesherlock-beta-mcp-server 0.0.1 → 0.0.3

package/.env

@@ -1,7 +1,7 @@
 # Environment Configuration
 
 # Backend API Configuration
-BACKEND_API_URL=https://api.test.codesherlock.ai
+BACKEND_API_URL=http://127.0.0.1:8000
 
 
 # Application Insights Configuration

package/README.md

@@ -1,5 +1,8 @@
 # CodeSherlock MCP Server - Setup & Usage Guide
 
+> **⚠️ Beta Version Notice**  
+> This is a beta release of the CodeSherlock MCP Server. Features may change, and some functionality may be experimental. We welcome your feedback to help us improve!
+
 **Key Features:**
 - Analyze uncommitted changes (staged and unstaged files)
 - Analyze committed changes (from your latest commit)
@@ -11,9 +14,9 @@
 ## Prerequisites
 
 Before you begin, ensure you have:
-- Node.js (version [INSERT VERSION HERE]) and npm installed on your system
+- Node.js (version 18.0.0 or higher) and npm installed on your system
 - A Git repository with code you want to analyze
-- An AI coding assistant that supports MCP (e.g., Claude Desktop, Cline, or similar)
+- An AI coding assistant that supports MCP (e.g., Claude Code, Cursor, VS Code, Cline, or similar)
 
 The CodeSherlock MCP Server is available on the npm registry and can be used directly with `npx`.
 
@@ -41,38 +44,304 @@ CodeSherlock requires an API key to analyze your code. This API Key is used to a
 
 ## Step 2: Configure Your AI Assistant
 
-You need to add the CodeSherlock MCP Server configuration to your AI assistant's settings. Below given are the documentation links for popular AI assistants to setup MCP server:
+You need to add the CodeSherlock MCP Server configuration to your AI assistant's settings. Follow the instructions for your preferred IDE/assistant below.
+
+**Quick Links:**
+- [Cursor](#cursor)
+- [Windsurf](#windsurf)
+- [Claude Code](#claude-code)
+- [VS Code](#vs-code)
+- [IntelliJ IDEA](#intellij-idea)
+- [Cline](#cline)
 
-- [Cluade Code](https://code.claude.com/docs/en/mcp#option-3%3A-add-a-local-stdio-server)
-- [Cursor](https://cursor.com/docs/context/mcp#using-mcpjson)
-- [VS Code / GitHub Copilot](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)
+---
 
-<br/>
+### Cursor
 
-The general pattern is to specify:
-- **Command**: `npx`
-- **Args**: `[-y, codesherlock-mcp-server]`
-- **Server Name**: `codesherlock`
+#### Steps to Configure
 
-#### MCP Configuration JSON:
+1. Click the **Settings** (gear icon) on the top right corner
+2. Settings panel opens as a new tab in the center of the screen
+3. In the settings sidebar, navigate to **Tools & MCP** section
+4. Click on **New MCP Server** button
+5. This opens the `mcp.json` config file
+6. Add the configuration below and save
+7. Restart Cursor
+
+#### Configuration
 
 ```json
 {
   "mcpServers": {
     "codesherlock": {
-      "name": "CodeSherlock alpha MCP Server",
+      "name": "CodeSherlock MCP Server (Beta)",
       "description": "CodeSherlock delivers deep code analysis and exposes MCP tools for commit analysis and uncommit analysis.",
       "command": "npx",
-      "args": ["-y", "@codesherlock/codesherlock-alpha-mcp-server"],
+      "args": [
+        "-y",
+        "codesherlock-mcp-server"
+      ],
+      "env": {
+        "MCP_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Config File Location
+
+| OS | Path |
+|----|------|
+| **Windows** | `C:\Users\<Username>\.cursor\mcp.json` |
+| **macOS** | `~/.cursor/mcp.json` |
+
+---
+
+### Windsurf
+
+#### Steps to Configure
+
+1. Click on the **Settings** (gear icon) on the top right corner and select **Windsurf Settings** (or press `Ctrl+,`)
+2. In the settings search box, type **mcp**
+3. Find the **MCP Servers** section
+4. Click on **Open MCP Marketplace**
+5. In the MCP Marketplace, click the **Settings** (gear icon) to add a custom server
+6. This opens the `mcp_config.json` config file
+7. Add the configuration below and save
+8. Restart Windsurf
+
+#### Configuration
+
+```json
+{
+  "mcpServers": {
+    "codesherlock": {
+      "name": "CodeSherlock MCP Server (Beta)",
+      "description": "CodeSherlock delivers deep code analysis and exposes MCP tools for commit analysis and uncommit analysis.",
+      "command": "npx",
+      "args": [
+        "-y",
+        "codesherlock-mcp-server"
+      ],
+      "env": {
+        "MCP_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Config File Location
+
+| OS | Path |
+|----|------|
+| **Windows** | `C:\Users\<Username>\.codeium\windsurf\mcp_config.json` |
+| **macOS** | `~/.codeium/windsurf/mcp_config.json` |
+
+---
+
+### Claude Code
+
+#### Steps to Configure
+
+Run the following command in your terminal:
+
+```bash
+claude mcp add codesherlock -e MCP_API_KEY=your-api-key-here -- npx -y codesherlock-mcp-server
+```
+
+**Other useful commands:**
+```bash
+claude mcp list                  # List all configured servers
+claude mcp remove codesherlock   # Remove a server
+```
+
+#### Configuration
+
+**Manually add to config file (optional):**
+```json
+{
+  "mcpServers": {
+    "codesherlock": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "codesherlock-mcp-server"
+      ],
       "env": {
-        "CODESHERLOCK_API_KEY": "your-api-key-here"
+        "MCP_API_KEY": "your-api-key-here"
       }
     }
   }
 }
 ```
 
-*After adding the configuration, restart your AI assistant to load the MCP server.*
+#### Config File Location
+
+| OS | Path |
+|----|------|
+| **Windows** | `%APPDATA%\Claude\claude_desktop_config.json` |
+| **macOS** | `~/.claude/claude_desktop_config.json` |
+
+---
+
+### VS Code
+
+#### Steps to Configure
+
+1. Press `Ctrl+Shift+P` (Windows) or `Cmd+Shift+P` (macOS) to open Command Palette
+2. Type **MCP: Open User Configuration**
+3. This opens the `mcp.json` config file
+4. Add the configuration below and save
+5. Restart VS Code
+
+#### Configuration
+
+```json
+{
+  "mcpServers": {
+    "codesherlock": {
+      "name": "CodeSherlock MCP Server (Beta)",
+      "description": "CodeSherlock delivers deep code analysis and exposes MCP tools for commit analysis and uncommit analysis.",
+      "command": "npx",
+      "args": [
+        "-y",
+        "codesherlock-mcp-server"
+      ],
+      "env": {
+        "MCP_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Config File Location
+
+| OS | Path |
+|----|------|
+| **Windows** | `C:\Users\<Username>\AppData\Roaming\Code\User\mcp.json` |
+| **macOS** | `~/Library/Application Support/Code/User/mcp.json` |
+
+---
+
+### IntelliJ IDEA
+
+#### Steps to Configure
+
+**Method 1: Using JetBrains AI Assistant**
+
+*Requires JetBrains AI Assistant plugin installed*
+
+1. Click on the **Settings** (gear icon)
+2. Navigate to **Tools** → **AI Assistant** → **MCP**
+3. Add the configuration below and save
+4. Restart IntelliJ IDEA
+
+**Method 2: Using GitHub Copilot**
+
+*Requires GitHub Copilot plugin installed*
+
+1. Click on the **Settings** (gear icon)
+2. Navigate to **Tools** → **GitHub Copilot** → **MCP**
+3. Add the configuration below and save
+4. Restart IntelliJ IDEA
+
+#### Configuration
+
+**For JetBrains AI Assistant:**
+```json
+{
+  "mcpServers": {
+    "codesherlock": {
+      "name": "CodeSherlock MCP Server (Beta)",
+      "description": "CodeSherlock delivers deep code analysis and exposes MCP tools for commit analysis and uncommit analysis.",
+      "command": "C:\\Program Files\\nodejs\\npx.cmd",
+      "args": [
+        "-y",
+        "codesherlock-mcp-server"
+      ],
+      "env": {
+        "MCP_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**For GitHub Copilot:**
+```json
+{
+  "servers": {
+    "codesherlock": {
+      "name": "CodeSherlock MCP Server (Beta)",
+      "description": "CodeSherlock delivers deep code analysis and exposes MCP tools for commit analysis and uncommit analysis.",
+      "command": "npx",
+      "args": [
+        "-y",
+        "codesherlock-mcp-server"
+      ],
+      "env": {
+        "MCP_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Config File Location
+
+**GitHub Copilot:**
+
+| OS | Path |
+|----|------|
+| **Windows** | `C:\Users\<Username>\AppData\Local\github-copilot\intellij\mcp.json` |
+| **macOS** | `~/Library/Application Support/github-copilot/intellij/mcp.json` |
+
+---
+
+### Cline
+
+*Cline is a VS Code extension. Install it from the VS Code marketplace or other supported IDEs.*
+
+#### Steps to Configure
+
+1. Open Cline panel in VS Code
+2. Click on **Manage MCP Servers**
+3. Click on the **Settings** (gear icon)
+4. Click on **Configure MCP Servers** button
+5. This opens the `cline_mcp_settings.json` config file
+6. Add the configuration below and save
+7. Restart VS Code
+
+#### Configuration
+
+```json
+{
+  "mcpServers": {
+    "codesherlock": {
+      "name": "CodeSherlock MCP Server (Beta)",
+      "description": "CodeSherlock delivers deep code analysis and exposes MCP tools for commit analysis and uncommit analysis.",
+      "command": "npx",
+      "args": [
+        "-y",
+        "codesherlock-mcp-server"
+      ],
+      "env": {
+        "MCP_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+#### Config File Location
+
+| OS | Path |
+|----|------|
+| **Windows** | `C:\Users\<Username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json` |
+| **macOS** | `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
 
 ---
 
@@ -86,7 +355,7 @@ CodeSherlock supports three analysis factors:
 
 | Factor | Description |
 |--------|-------------|
-| **power analysis** | A A full-spectrum scan that covers the most essential and critical issues |
+| **power analysis** | A full-spectrum scan that covers the most essential and critical issues |
 | **owasp** | Security analysis based on OWASP Top 10 vulnerabilities |
 | **cwe** | Analyzes code against Common Weakness Enumeration (CWE) framework |
 
@@ -107,9 +376,11 @@ Here are practical examples of how to prompt your AI assistant to perform code a
 ```
 "Analyze my latest commit for OWASP vulnerabilities using CodeSherlock"
 ```
+
 ```
 "Check the last commit in my current repo for CWE issues with CodeSherlock"
 ```
+
 ---
 
 ## Understanding the Results
@@ -180,6 +451,17 @@ The AI assistant will present the analysis results in a readable format, typical
 
 ---
 
+## Beta Version Feedback
+
+As this is a beta release, we're actively seeking feedback to improve the CodeSherlock MCP Server. If you encounter any issues, have suggestions, or want to report bugs, please:
+
+- Send us an email at [support@codesherlock.ai](mailto:support@codesherlock.ai)
+- Include details about your environment, the issue you encountered, and any error messages
+
+Your feedback helps us make CodeSherlock better for everyone!
+
+---
+
 ## Getting Help
 
-If you face any issues, please send us a mail at [support@codesherlock.ai](mailto:support@codesherlock.ai). We will help you resolve the issue as soon as possible.
+If you face any issues, please send us a mail at [support@codesherlock.ai](mailto:support@codesherlock.ai). We will help you resolve the issue as soon as possible.

package/build/handlers/tools.js

@@ -21,7 +21,7 @@ export function registerTools(server) {
      */
     server.registerTool("analyze_commit", {
         title: "Analyze Commit",
-        description: "Analyze a Git commit or uncommitted changes by fetching diff and sending to backend for analysis",
+        description: "CodeSherlock is an AI- based code analysis tool that validates unstaged changes and commits directly inside IDEs and AI Agents. It helps developers catch security, quality, and design issues early by combining deep analysis with compliance-aware checks OWASP, CWE, SOC-2 at the moment code is written. CodeSherlock also performs other security vulnerability reviews along with Maintainability, Reliability and Scalability checks. Use CodeSherlock to review and validate code especially generated via AI.",
         inputSchema: AnalyzeCommitInputSchema,
         outputSchema: AnalyzeCommitOutputSchema,
     }, createAnalyzeCommitHandler(gitService, commitReviewService, backendApiService));

package/build/handlers/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC3C,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAEpC,0CAA0C;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC/C,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,UAAU,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE1D,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAC3C,UAAiB,EACjB,OAAO,CAAC,GAAG,CAAC,WAAW,CAC1B,CAAC;IACF,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAEvE;;;OAGG;IACH,MAAM,CAAC,YAAY,CACf,gBAAgB,EAChB;QACI,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,kGAAkG;QAC/G,WAAW,EAAE,wBAAwB;QACrC,YAAY,EAAE,yBAAyB;KAC1C,EACD,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,CAAC,CACjF,CAAC;AACN,CAAC"}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/handlers/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC3C,MAAM,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC;IAEpC,0CAA0C;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC/C,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,UAAU,CAAC,CAAC;IAC7C,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAE1D,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,CAC3C,UAAiB,EACjB,OAAO,CAAC,GAAG,CAAC,WAAW,CAC1B,CAAC;IACF,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;IAEvE;;;OAGG;IACH,MAAM,CAAC,YAAY,CACf,gBAAgB,EAChB;QACI,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,yfAAyf;QACtgB,WAAW,EAAE,wBAAwB;QACrC,YAAY,EAAE,yBAAyB;KAC1C,EACD,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,EAAE,iBAAiB,CAAC,CACjF,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@codesherlock/codesherlock-beta-mcp-server",
-    "version": "0.0.1",
+    "version": "0.0.3",
     "description": "A TypeScript-based Model Context Protocol (MCP) server",
     "main": "build/index.js",
     "bin": {