Code Scanner Server

What is Code Scanner Server?

Code Scanner Server is 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). It is built with TypeScript and Node.js, uses the Tree-sitter parsing library, and is intended for developers who need to extract structural information from codebases programmatically or via AI assistants.

How to use Code Scanner Server?

Install dependencies with npm install, then build the TypeScript code with npm run build. Run as a CLI tool by executing node build/index.js --directory /path/to/codebase with optional flags. To use as an MCP server, omit the --directory argument; then add the server to your MCP client configuration (e.g., claude_desktop_config.json) with the absolute path to build/index.js.

Key features of Code Scanner Server

• Extracts definitions like classes, functions, and methods.
• Supports JavaScript, TypeScript, C#, PHP, CSS, and Python.
• Automatically respects .gitignore rules.
• Filters by definition type, modifiers, name patterns, and file paths.
• Outputs results in Markdown, XML, or JSON.
• Runs as a CLI tool or as an MCP server.

Use cases of Code Scanner Server

• Quickly generate a structured summary of a codebase for documentation or review.
• Feed code definitions into an AI assistant for context-aware analysis.
• Automate codebase indexing by extracting symbol locations and line numbers.
• Integrate with MCP‑compatible IDEs or chat clients to scan a project on demand.

FAQ from Code Scanner Server

What programming languages does Code Scanner Server support?

It parses JavaScript (.js, .jsx), TypeScript (.ts, .tsx), C# (.cs), PHP (.php), CSS (.css), and Python (.py) via Tree-sitter.

How do I configure Code Scanner Server as an MCP server?

Add an entry to your MCP client configuration (e.g., claude_desktop_config.json) with the command node and the absolute path to build/index.js as the argument. Then restart your MCP client.

What output formats are available?

You can choose between Markdown (default), XML, and JSON using the --format flag.

Is Code Scanner Server stable?

The tool is under active development. Core functionality is operational, but some features or language parsers may not be fully tested and might contain bugs or limitations.

What are the runtime requirements?

You need Node.js and npm installed. The tool is built with TypeScript and requires a build step (npm run build) before first use.