MikeRecognex/mcp-codebase-index

What's New

Added optional max_results and max_lines parameters to all MCP tools that can produce large responses. This prevents unbounded results from blowing up token budgets in messaging-based AI agents (e.g. OpenClaw sends full conversation history every turn).

All parameters default to preserving current behavior — existing clients see no change.

Convention

• 0 = unlimited (no truncation) — the default for all parameters except search_codebase which defaults to 100 (matching its previous hardcoded limit)
• Any positive integer caps the result
• Source truncation appends ... (truncated to N lines) when content is actually cut

Tools with max_results (list truncation)

| Tool | Default |
|------|---------|
| list_files | 0 (unlimited) |
| get_functions | 0 (unlimited) |
| get_classes | 0 (unlimited) |
| get_imports | 0 (unlimited) |
| get_dependencies | 0 (unlimited) |
| get_dependents | 0 (unlimited) |
| get_file_dependencies | 0 (unlimited) |
| get_file_dependents | 0 (unlimited) |
| search_codebase | 100 |

Tools with max_lines (source truncation)

| Tool | Default |
|------|---------|
| get_function_source | 0 (unlimited) |
| get_class_source | 0 (unlimited) |

Tools with max_direct / max_transitive (impact analysis)

| Tool | Default |
|------|---------|
| get_change_impact | both 0 (unlimited) |

Example Usage

{"name": "get_functions", "arguments": {"max_results": 20}}
{"name": "get_class_source", "arguments": {"name": "Engine", "max_lines": 50}}
{"name": "get_change_impact", "arguments": {"name": "helper", "max_direct": 5, "max_transitive": 10}}

Install

pip install mcp-codebase-index==0.2.0

Full Changelog: https://github.com/MikeRecognex/mcp-codebase-index/compare/v0.1.3...v0.2.0