PasNavigator MCP

MCP server for semantic navigation in Delphi/Pascal codebases.

The long-term design is:

• Delphi-based indexer/backend that reuses ideas and code from CodeComparer
• thin MCP server layer that exposes project indexing and symbol navigation tools
• compact symbol-level responses for AI agents instead of raw grep output

Current status

This repository contains:

• Python MCP tool surface and process adapter
• Delphi console backend with vendored CodeComparer/DelphiAST sources under delphi/vendor/codecomparer/
• no runtime dependency on a live CodeComparer repository checkout

DevExpress VCL is still required to compile the Delphi indexer (DXVCL).

The vendored importer carries a few local changes so that defines and unit_scopes reach the parser; they are listed in delphi/vendor/codecomparer/NOTICE.txt.

Docs:

• protocol: docs/delphi-backend-protocol.md
• Delphi build: delphi/README.md

Tools

• open_project, open_project_from_config
• project_status
• find_symbol — ranked, capped, reports total_count
• get_symbol
• get_hierarchy
• get_descendants
• get_source

Configuration

Example project configuration:

{
  "project_name": "MyApp",
  "roots": [
    "E:/Work/MyApp/Source",
    "E:/Work/MyApp/Modules"
  ],
  "search_paths": [
    "E:/Libs/Common",
    "C:/RAD/Studio/22.0/source/vcl"
  ],
  "defines": ["MSWINDOWS", "VER350"],
  "unit_scopes": ["System", "Vcl", "Winapi"],
  "excludes": ["**/__history/**", "**/backup/**"]
}

Development

Create a virtual environment and install the package in editable mode:

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .

Run the server with the in-memory stub:

python -m pasnavigator_mcp

Talk to the Delphi console backend (stub build, no DevExpress):

$env:PASNAVIGATOR_BACKEND = "delphi"
$env:PASNAVIGATOR_DELPHI_EXE = "E:\Github_dm75\PasNavigator_MCP\delphi\bin\Win32\Debug\PasNavigatorBackend.exe"
python -m pasnavigator_mcp

Run the tests. Cases that need the compiled backend skip themselves when PasNavigatorBackend.exe is missing; the rest run against a Python fake process:

python -m unittest discover -s tests

Next step

The MCP layer itself (server.py, config.py) has no test coverage, because the mcp dependency has not been installable in this environment.