PasNavigator MCP

Servidor MCP para navegación semántica en bases de código Delphi/Pascal.

El diseño a largo plazo es:

• indexador/backend basado en Delphi que reutiliza ideas y código de CodeComparer

• capa fina de servidor MCP que expone herramientas de indexación de proyectos y navegación de símbolos

• respuestas compactas a nivel de símbolo para agentes de IA en lugar de salida cruda de grep

Estado actual

Este repositorio contiene:

• superficie de herramientas MCP en Python y adaptador de procesos

• backend de consola en Delphi con fuentes de CodeComparer/DelphiAST incluidas bajo delphi/vendor/codecomparer/

• sin dependencia en tiempo de ejecución de un checkout en vivo del repositorio CodeComparer

DevExpress VCL sigue siendo necesario para compilar el indexador Delphi (DXVCL).

El importador incluido lleva algunos cambios locales para que defines y unit_scopes lleguen al analizador; están listados en delphi/vendor/codecomparer/NOTICE.txt.

Documentación:

• protocolo: docs/delphi-backend-protocol.md

• compilación Delphi: delphi/README.md

Related MCP server: Delphi Compiler MCP

Herramientas

• open_project, open_project_from_config

• project_status

• find_symbol — clasificado, limitado, informa total_count

• get_symbol

• get_hierarchy

• get_descendants

• get_source

Configuración

Ejemplo de configuración de proyecto:

{
  "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/**"]
}

Desarrollo

Crea un entorno virtual e instala el paquete en modo editable:

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

Ejecuta el servidor con el stub en memoria:

python -m pasnavigator_mcp

Habla con el backend de consola Delphi (compilación stub, sin DevExpress):

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

Ejecuta las pruebas. Los casos que necesitan el backend compilado se omiten a sí mismos cuando PasNavigatorBackend.exe falta; el resto se ejecuta contra un proceso falso en Python:

python -m unittest discover -s tests

Siguiente paso

La capa MCP en sí (server.py, config.py) no tiene cobertura de pruebas, porque la dependencia mcp no ha sido instalable en este entorno.