Code Index MCP

Build the deep index (full symbol extraction) for the current project.

This performs a complete re-index and loads it into memory. Uses parallel processing by default. For large codebases (3000+ files), tuning max_workers can significantly improve build times.

Args: max_workers: Maximum number of parallel workers for file processing. Defaults to min(4, cpu_count) when not specified. Increase for I/O-bound workloads on machines with many cores. timeout: Parallel build timeout in seconds. When not specified, scales dynamically based on file count (0.5s per file, min 30s, max 600s).

Check the temporary directory used for storing index data.

Clear all settings and cached data.

Configure file watcher service settings.

Args: enabled: Whether to enable file watcher debounce_seconds: Debounce time in seconds before triggering rebuild additional_exclude_patterns: Additional directory/file patterns to exclude observer_type: Observer backend to use. Options:

• "auto" (default): platform default observer
• "kqueue": Force kqueue observer (macOS/BSD)
• "fsevents": Force FSEvents observer (macOS only, has known reliability issues)
• "polling": Cross-platform polling fallback (slower but most compatible)

Create the temporary directory used for storing index data.

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

Get a summary of a specific file, including:

• Line count
• Function/class definitions (for supported languages)
• Import statements
• Basic complexity metrics

Get file watcher service status and statistics.

Get information about the project settings.

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

Manually rebuild the project file index. Use after git operations or when index seems stale.

Manually re-detect the available command-line search tools on the system. This is useful if you have installed a new tool (like ripgrep) after starting the server.

Search for code pattern with pagination. Auto-selects best search tool (ugrep/ripgrep/ag/grep). Supports glob file_pattern (e.g., "*.py"), explicit regex mode, and fuzzy matching (ugrep only). Regex matching requires passing regex=True and may require an external search tool.

Set the base project path for indexing.