codescope - MCP Server Documentation

🔌 Connection Information

MCP Endpoint

https://codescope-6a464f0d-yashs-org-7b2c3fdc.app.nitrocloud.ai/mcp

Connect to this MCP server using the endpoint above. The server supports Server-Sent Events (SSE) for real-time bidirectional communication following the Model Context Protocol specification.

🛠️ Available Tools

analyze-project

Analyze a TypeScript/JavaScript project and return overall metrics including file count, lines of code, complexity score, and security issues

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory to analyze"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

find-complex-functions

Find functions with high cyclomatic complexity in a project

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory"
    },
    "threshold": {
      "type": "number",
      "description": "Complexity threshold (default: 5)"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

security-audit

Audit a project for common security vulnerabilities including hardcoded secrets, eval usage, innerHTML, SQL injection risks, and debugger statements

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

find-dead-code

Find dead code including unused exports, unreachable code, unused variables, and duplicate imports

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

detect-circular-dependencies

Detect circular dependencies in a project using depth-first search

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory"
    },
    "maxDepth": {
      "type": "number",
      "description": "Maximum depth for cycle detection (default: 10)"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

find-hotspots

Find hotspots in a project ranked by complexity or file size

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory"
    },
    "metric": {
      "type": "string",
      "enum": [
        "complexity",
        "size"
      ],
      "description": "Metric to rank by: complexity or size"
    }
  },
  "required": [
    "path",
    "metric"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

generate-dependency-graph

Generate an interactive dependency graph showing file relationships color-coded by complexity

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory"
    },
    "maxNodes": {
      "type": "number",
      "description": "Maximum nodes to include (default: 30)"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

generate-html-report

Generate a comprehensive HTML report aggregating findings from all 7 analysis tools: analyze-project, find-complex-functions, security-audit, find-dead-code, detect-circular-dependencies, and find-hotspots

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory to analyze"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}

generate-code-health-score

Compute an overall 0-100 code health score with letter grade and ranked recommendations

Input Schema

{
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to the project directory to analyze"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object"
}