<a href="https://glama.ai/mcp/servers/@Ixe1/code-scanner-server">

</a>

code-scanner-server

> A CLI tool and MCP server that scans code files for definitions (classes, functions, etc.), respects .gitignore, provides line numbers, and outputs LLM-friendly formats (XML/Markdown).

This project provides a versatile code scanning tool built with TypeScript and Node.js. It leverages the Tree-sitter parsing library to analyze source code and extract structural information. It can operate both as a command-line interface (CLI) tool and as an MCP (Model Context Protocol) server.

> Note: This tool is under active development. While core functionality is operational, some features or specific language parsers may not be fully tested and might contain bugs or limitations.

Features

Code Definition Extraction: Identifies functions, classes, variables, interfaces, methods, etc.
Multi-Language Support: Parses JavaScript (.js, .jsx), TypeScript (.ts, .tsx), C# (.cs), PHP (.php), CSS (.css), and Python (.py) via Tree-sitter.
.gitignore Aware: Automatically respects rules defined in .gitignore files.
Flexible Filtering: Filter results by definition type, modifiers (public, private), name patterns (regex), and file path patterns.
Multiple Output Formats: Generates results in Markdown (default), XML, or JSON.
Configurable Detail Levels: Output verbosity: minimal, standard (default), detailed.
Dual Mode Operation: Run as a standalone CLI tool or as an integrated MCP server.

node build/index.js --directory /path/to/your/codebase

Common Options:
-d, --directory <path>: (Required) Absolute or relative path to the directory to scan.
-p, --patterns <patterns...>: Glob patterns for file extensions (e.g., "/.ts" "/.js"). Defaults to JS, TSX, CS, PHP, CSS, PY files.
-f, --format <format>: Output format (xml, markdown, json). Default: markdown.
-l, --detail <level>: Level of detail (minimal, standard, detailed). Default: standard.
--include-types <types...>: Only include specific definition types (e.g., class, method).
--exclude-types <types...>: Exclude specific definition types.
--include-modifiers <modifiers...>: Only include definitions with specific modifiers (e.g., public).
--exclude-modifiers <modifiers...>: Exclude definitions with specific modifiers.
--name-pattern <regex>: Include definitions matching a JavaScript regex pattern.
--exclude-name-pattern <regex>: Exclude definitions matching a JavaScript regex pattern.
--include-paths <paths...>: Additional file path patterns (glob) to include.
--exclude-paths <paths...>: File path patterns (glob) to exclude.
-h, --help: Display detailed help information for all options.

Example (Scan TypeScript files in src, output detailed JSON):

node build/index.js -d ./src -p "/.ts" -f json -l detailed

Tool Name: scan_code
Description: Scans a specified directory for code files and returns a list of definitions according to the provided filters.
Input Schema: Accepts arguments corresponding to the CLI options. The directory property is required.

    {

      "type": "object",

      "properties": {

        "directory": { "type": "string", "description": "Absolute path to the directory to scan." },

        "filePatterns": { "type": "array", "items": { "type": "string" }, "description": "Glob patterns for files.", "default": ["/.js", ..., "/.py"] },

        "outputFormat": { "type": "string", "enum": ["xml", "markdown", "json"], "default": "markdown" },

        "detailLevel": { "type": "string", "enum": ["minimal", "standard", "detailed"], "default": "standard" },

        "includeTypes": { "type": "array", "items": { "type": "string" } },

        "excludeTypes": { "type": "array", "items": { "type": "string" } },

        "includeModifiers": { "type": "array", "items": { "type": "string" } },

        "excludeModifiers": { "type": "array", "items": { "type": "string" } },

        "namePattern": { "type": "string", "description": "Regex pattern for names." },

        "excludeNamePattern": { "type": "string", "description": "Regex pattern to exclude names." },

        "includePaths": { "type": "array", "items": { "type": "string" } },

        "excludePaths": { "type": "array", "items": { "type": "string" } }

      },

      "required": ["directory"]

    }

    

    # git clone <repository_url>

    # cd code-scanner-server

    

    npm install

    

    npm run build

    

{

  "mcpServers": {

    "code-scanner-server": {

      "command": "node",

      "args": [

        "/absolute/path/to/your/code-scanner-server/build/index.js" // <-- Replace this path! (e.g., "C:\\Users\\YourUser\\Projects\\code-scanner-server\\build\\index.js" on Windows)

      ],

      "env": {},

      "disabled": false,

      "autoApprove": [] // Add tool names here for auto-approval if desired

    }

  }

}

Watch Mode: Automatically rebuild the project when source files change:

    npm run watch

    

    npm run inspector

    

Acknowledgments

This project was significantly developed with the assistance of AI, primarily using Google's Gemini 2.5 Pro model accessed via the Roo Code extension for Visual Studio Code.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.