PasNavigator MCP

Delphi/Pascal 코드베이스에서 의미론적 탐색을 위한 MCP 서버입니다.

장기 설계는 다음과 같습니다:

• CodeComparer의 아이디어와 코드를 재사용하는 Delphi 기반 인덱서/백엔드

• 프로젝트 인덱싱 및 심볼 탐색 도구를 노출하는 얇은 MCP 서버 계층

• 원시 grep 출력 대신 AI 에이전트를 위한 간결한 심볼 수준 응답

현재 상태

이 저장소에는 다음이 포함되어 있습니다:

• Python MCP 도구 표면 및 프로세스 어댑터

• delphi/vendor/codecomparer/ 아래에 vendored CodeComparer/DelphiAST 소스가 있는 Delphi 콘솔 백엔드

• 라이브 CodeComparer 저장소 체크아웃에 대한 런타임 의존성 없음

Delphi 인덱서를 컴파일하려면 여전히 DevExpress VCL이 필요합니다 (DXVCL).

Vendored importer는 defines와 unit_scopes가 파서에 도달하도록 몇 가지 로컬 변경 사항을 포함합니다. 이 변경 사항은 delphi/vendor/codecomparer/NOTICE.txt에 나열되어 있습니다.

문서:

• 프로토콜: docs/delphi-backend-protocol.md

• Delphi 빌드: delphi/README.md

Related MCP server: Delphi Compiler MCP

도구

• open_project, open_project_from_config

• project_status

• find_symbol — 순위 지정, 상한 설정, total_count 보고

• get_symbol

• get_hierarchy

• get_descendants

• get_source

구성

예제 프로젝트 구성:

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

개발

가상 환경을 만들고 패키지를 편집 가능 모드로 설치합니다:

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

인메모리 스텁으로 서버를 실행합니다:

python -m pasnavigator_mcp

Delphi 콘솔 백엔드와 통신합니다 (스텁 빌드, DevExpress 없음):

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

테스트를 실행합니다. 컴파일된 백엔드가 필요한 테스트는 PasNavigatorBackend.exe가 없으면 스스로 건너뛰고, 나머지는 Python 가짜 프로세스에 대해 실행됩니다:

python -m unittest discover -s tests

다음 단계

MCP 계층 자체(server.py, config.py)에는 테스트 커버리지가 없습니다. 이 환경에서 mcp 의존성을 설치할 수 없었기 때문입니다.