Code Index MCP

MCPOpen Source11.5

by BangNGH • Search & Retrieval

An MCP server that indexes, searches, and analyzes code in project directories to help LLM agents explore and reason about codebases.

Example Use Cases

1
Search a project's codebase for symbols, function names, or patterns across multiple file types quickly.
2
Generate summaries or lists of functions/classes and analyze file-level structure and complexity.
3
Navigate project structure, locate matching files (e.g., test_*.py), and persist indexing state between runs.

Description

Code Index MCP is a Model Context Protocol server that builds and persists an index of a project's files to enable fast searching, file summaries, and code analysis. It supports many common programming languages, provides pattern search and file-level analysis (e.g., function lists, complexity insights), and stores index/config data in a .code_indexer folder to avoid repeated re-indexing. The server integrates with UV for dependency management and can be run standalone or integrated with Claude Desktop for LLM-driven developer workflows. Security-minded features include path validation and restrictions on absolute path access.

Capabilities(14 total)

Tools (14)

set_project_path

Set the base project path for indexing.

path:string*

search_code_advanced

Search for code pattern with pagination. Auto-selects best search tool (ugrep/ripgrep/ag/grep). Supports glob file_pattern (e.g., "*.py"), regex patterns, and fuzzy matching (ugrep only).

pattern:string*case_sensitive:booleancontext_lines:integerfile_pattern:stringfuzzy:booleanregex:booleanstart_index:integermax_results:any

find_files

Find files matching glob pattern using in-memory index. Supports path patterns (*.py, test_*.js) and filename-only matching (README.md).

pattern:string*

get_file_summary

Get a summary of a specific file, including: - Line count - Function/class definitions (for supported languages) - Import statements - Basic complexity metrics

file_path:string*

get_symbol_body

Get the source code body of a specific symbol (function, method, or class). This tool retrieves only the code for the specified symbol, enabling efficient context usage by avoiding loading entire files. Args: file_path: Path to the file containing the symbol symbol_name: Name of the symbol to retrieve (e.g., "process_data", "MyClass.my_method") Returns: Dictionary containing: - status: "success" or "error" - symbol_name: Name of the symbol - type: Type of symbol (function, method, class) - line: Start line number - end_line: End line number - code: The actual source code - signature: Function/method signature (if available) - docstring: Documentation string (if available) - called_by: List of symbols that call this symbol

file_path:string*symbol_name:string*

Quick Actions

View on GitHub

Security

Scanned 2 month(s) ago

Risk Level

LOW

Reads external data but no write or execute capability

Trust Score

C50/100

7/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities14 Tools / 0 Prompts / 0 Resources

OwnerBangNGH

CategorySearch & Retrieval

DependenciesStandalone

Set Your Username