agentless-mcp

agentless-mcp은 코딩 에이전트를 위한 모델 없는 구조적 메커니즘입니다: 요청 시 제공되는 트리-시터 저장소 맵(디렉터리 트리, 골격, 라인 슬라이스 등 모든 확대 수준), 버그 위치 파악을 위한 심볼 및 참조 조회, 결정론적 패치 파싱, 구문 검사 및 후보 검증을 제공합니다. 언어 모델을 호출하지 않습니다 — 호출하는 에이전트가 모든 추론을 담당하고, 이 도구는 그렇지 않으면 즉흥적으로 처리해야 할 파싱, 순위 지정, 포함 및 검증을 제공합니다. CLI로 제공되어 모든 에이전트가 Bash를 통해 호출할 수 있으며, 동일한 코어 위에서 경량 stdio MCP 서버로도 제공됩니다.

설치

현재는 git에서 설치합니다:

uv tool install git+https://github.com/dmarlow-personal/agentless-mcp
agentless-mcp warmup

stdio 서버를 위해 mcp 엑스트라를 추가하세요 (uv tool install "agentless-mcp[mcp] @ git+..."). PyPI 릴리스가 곧 제공될 예정입니다. 그때까지는 git URL이 설치 경로입니다.

Related MCP server: agentmako

상태

1단계부터 6단계까지 완료되었습니다. CLI와 stdio MCP 서버는 모두 하나의 애플리케이션 서비스 세트 위에서 작동합니다: 저장소 맵, 디렉터리 트리, 골격, 슬라이스, 심볼 조회, 심볼 확장, 팬-인, 위치 해석, 그리고 해석된 그래프 뷰 — explain(한 심볼의 계층적 팬-인 및 팬-아웃), path(두 심볼 사이의 최단 해석 경로), cycles(모듈 수준 가져오기 순환)입니다. 쓰기 측면 — SEARCH/REPLACE 패치 파싱, 구문 검사, 작업 트리 격리 적용, 후보 검증 및 동등성 클러스터 투표 — 은 CLI 전용이며 MCP를 통해 노출되지 않습니다.

참조 해석은 결정론적이며 모델이 없습니다: 이름은 파일 자체의 imports와 자체 정의를 통해 후보 정의에 바인딩되며, 모든 엣지는 그 뒤에 있는 개별 증거 계층(같은 파일, import를 통한 해석, 고유, 이름-만-모호)을 전달합니다. 그래프는 호출할 때마다 현재 트리에서 메모리에 조립됩니다. 저장되는 것은 없으며 watcher도 없습니다.

파싱은 기본적으로 요청 시 수행됩니다. agentless-mcp index는 $XDG_CACHE_HOME/agentless-mcp/(분석 중인 저장소 안이 아님)에 저장소별 SQLite 캐시를 구축하며, sha256이 변경되지 않은 파일의 심볼, 임포트 및 참조를 보관합니다. 모든 응답의 영수증에는 캐시 생성과 캐시가 여전히 해당 저장소의 것인지 여부가 명시되며, --no-cache / no_cache: true는 요청 시 파싱을 강제합니다.

저장소는 선택적 .agentless-mcp.json 파일(맵 예산, 최대 파일 수, 세분성, docstring, 추가 중지 단어, 그리고 명령줄에서 자체 테스트 명령을 지정하지 않은 경우에만, 또한 해당 명령을 출력한 후에만 CLI의 validate가 사용할 test_cmd)을 통해 자체 기본값을 선언할 수 있습니다. 이 파일은 저장소 콘텐츠입니다: 모든 값은 스키마 검사와 범위 제한을 거치며, 어떤 키도 경로 유형이 아니고, 알 수 없는 키는 오류가 아니라 응답 봉투의 경고입니다.

docs/agent-guide.md부터 시작하세요: 이 도구를 호출할 에이전트를 위해 작성된 사용 가이드입니다.

개발

uv sync --extra mcp
uv run agentless-mcp warmup
uv run pre-commit run --all-files
uv run pytest

uv run pre-commit run --all-files가 게이트입니다 — 이것은 수동으로 ruff를 실행하는 것의 엄격한 상위 집합입니다(ruff-format, mypy strict, codespell, import-linter 및 deptry를 추가합니다).

Windows 지원

Linux와 macOS가 지원되는 플랫폼입니다: 테스트 스위트가 실행되는 환경이며, 아래의 모든 보장이 여기서 검증됩니다. Windows는 문서화된 베스트 에포트입니다 — POSIX 전용 호출에는 Windows 경로가 있고, Windows CI는 없으며, 여기서 Windows에서 실행된 것은 없습니다.

포함된 항목:

• 전체 읽기 표면. 맵, 트리, 골격, 슬라이스, 심볼 조회, 팬-인, 위치 해석은 순수 파싱 및 경로 연산이며, 경로는 pathlib를 통해 전달되고 저장소-상대 결과는 슬래시로 정규화됩니다.

• 태그 캐시(단일 작성자 규율 포함). 인덱스 잠금은 POSIX에서 fcntl.flock이고 Windows에서 msvcrt.locking이며, util/filelock.py에서 선택됩니다. 둘 다 비차단이므로 두 플랫폼 모두에서 두 번째 동시 인덱스 실행은 대기열에 넣지 않고 거부됩니다.

• 패치 파싱, 구문 검사 및 동등성 키.

포함되지 않으며, 그 차이는 실질적입니다:

• 타임아웃 보장이 약합니다. POSIX에서는 시간 초과된 테스트 명령의 전체 프로세스 그룹이 종료됩니다(SIGTERM, 그 다음 SIGKILL). 따라서 시작된 모든 것이 종료됩니다. Windows에서는 자식 프로세스가 CREATE_NEW_PROCESS_GROUP으로 생성된 후 리더에게만 terminate()/kill()이 전송됩니다: 손자 프로세스는 시간 초과에서 살아남을 수 있습니다. 테스트 명령이 서버를 시작하면 직접 정리해야 합니다.

• Windows CI가 없습니다. 플랫폼 디스패치는 Linux에서 단위 테스트됩니다. Windows 시스템 호출 자체는 어디에서도 실행되지 않습니다.

• git worktree에 의존하는 모든 것은 로컬 git의 동작을 따릅니다. Windows 파일 시스템에서 테스트되지 않았습니다.

보안

분석 중인 저장소에 대한 도구의 동작은 읽기 전용 및 경로 제한입니다: MCP 표면은 읽기 도구만 노출하고, 패치 적용 및 테스트 실행은 CLI 측에 있으며 기본적으로 격리된 git worktree를 사용하며, 분석 중인 저장소 내부에는 캐시나 임시 파일이 기록되지 않습니다.

한 가지 공급망 주의사항을 미리 밝힙니다. 문법은 tree-sitter-language-pack에서 제공되며, 첫 사용 시 사전 빌드된 플랫폼 번들을 다운로드합니다. 이러한 번들은 릴리스 매니페스트에 대해 SHA-256으로 검증되며, 불일치 시 오류가 발생합니다. 그러나 매니페스트 자체(parsers.json)는 암호학적으로 서명되지 않았습니다. 우리는 이 위험을 버전 고정으로 수용합니다: tree-sitter 및 tree-sitter-language-pack은 하나의 단위로 고정되며, 가져오기는 명시적인 워밍업 단계로 제한되고, 캐시 디렉터리와 매니페스트 URL 모두 재정의할 수 있습니다. docs/agent-guide.md를 참조하세요.

보안

분석 중인 저장소에 대한 도구의 동작은 읽기 전용 및 경로 제한입니다: MCP 표면은 읽기 도구만 노출하고, 패치 적용 및 테스트 실행은 CLI 측이며 기본적으로 격리된 git 작업 트리에서 수행되며, 분석 중인 저장소 내부에는 캐시나 임시 상태가 기록되지 않습니다.

한 가지 공급망 주의 사항을 미리 밝힙니다. 파서는 tree-sitter-language-pack에서 가져오며, 첫 사용 시 미리 빌드된 플랫폼 번들을 다운로드합니다. 해당 번들은 릴리스 매니페스트에 대해 sha256으로 검증되지만, 매니페스트 자체(parsers.json)는 암호화 서명이 아닌 릴리스 매니페스트에 대해 검증됩니다. 우리는 이 리스크를 엄격한 버전 고정으로 수용합니다: tree-sitter와 tree-sitter-language-pack은 단일 단위로 고정되며, 가져오기는 명시적 워밍업 단계로 제한되고, 캐시 디렉터리와 매니페스트 URL은 모두 재정의할 수 있습니다. 자세한 내용은 docs/supply-chain.md를 참조하세요.

보안

분석 대상 저장소에 대한 도구의 동작은 읽기 전용 및 경로 제한입니다: MCP 표면은 읽기 도구만 노출하며, 패치 적용 및 테스트 실행은 CLI 측이며 기본적으로 격리된 git 작업 트리에서 수행되고, 분석 중인 저장소 내부에는 캐시나 스크래치 상태가 저장되지 않습니다.

한 가지 공급망 주의사항을 먼저 언급할 가치가 있습니다. 파서는 tree-sitter-language-pack에서 제공되며, 이 패키지는 첫 사용 시 사전 빌드된 번들을 다운로드합니다. 해당 번들은 릴리스 매니페스트에 대해 sha256 검증을 거치며, 불일치는 거부됩니다. 그러나 매니페스트 자체(parsers.json)는 암호화 서명이 아닌 HTTPS 신뢰입니다. 배포는 정확한 릴리스 버전 고정으로 완화됩니다. tree-sitter-language-pack 및 해당 파서 버전은 각각 릴리스 버전에 고정되어 있으며, 업그레이드는 의도적으로 검토된 변경을 통해서만 이루어집니다. 가져오기는 번들 자체에서 직접 이루어지며, tree-sitter는 파서를 동적으로 로드하고, 실행 중에 네트워크 액세스는 없습니다.

보안

분석 중인 저장소에 대한 도구의 동작은 읽기 전용 및 경로 제한입니다: MCP 표면은 읽기 도구만 노출하고, 패치 적용 및 테스트 실행은 CLI 측에 있으며 기본적으로 격리된 git worktree를 사용하고, 분석 중인 저장소 내부에는 캐시나 스크래치 상태가 저장되지 않습니다.

한 가지 공급망 주의사항을 먼저 명시합니다. 문법은 tree-sitter-language-pack에서 제공되며, 이 패키지는 첫 사용 시 사전 빌드된 번들을 다운로드합니다. 해당 번들은 릴리스 매니페스트에 대해 sha256 검증을 거치며, 불일치는 거부됩니다. 그러나 매니페스트 자체(parsers.json)는 암호화 서명이 아닌 HTTPS 신뢰입니다. 가져오기는 정확한 릴리스 버전 고정으로 제한됩니다: tree-sitter-language-pack는 정확한 릴리스 버전으로 고정되어 있으며, 검토된 범프를 통해서만 이동합니다. 다운로드는 명시적인 웜업 단계에서만 발생하며, 매니페스트 URL과 다운로드 디렉터리는 미러 또는 오프라인 설치를 위해 재정의할 수 있습니다.

보안

분석 중인 저장소에 대한 도구의 동작은 읽기 전용 및 경로 제한입니다: MCP 표면은 읽기 도구만 노출하고, 패치 적용 및 테스트 실행은 CLI 측에 있으며 기본적으로 작업 트리 격리를 사용하며, 분석 중인 저장소 내부에는 캐시나 스크래치 상태가 기록되지 않습니다.

한 가지 공급망 주의사항을 먼저 언급할 가치가 있습니다. 파서는 tree-sitter-language-pack에서 제공되며, 첫 사용 시 사전 빌드된 번들을 다운로드합니다. 해당 번들은 릴리스 매니페스트에 대해 SHA-256으로 검증되며, 불일치 시 오류가 발생합니다. 그러나 매니페스트 자체(parsers.json)는 암호학적 서명이 아닌 HTTPS 신뢰입니다. 우리는 정확한 릴리스 버전 고정으로 이 위험을 수용합니다: tree-sitter와 tree-sitter-language-pack은 정확한 버전으로 고정되어 있으며, 검토된 범프를 통해서만 이동합니다. 가져오기는 명시적인 준비 단계로 제한되며, 매니페스트 URL과 캐시 디렉터리는 모두 재정의할 수 있습니다.

라이선스

MIT — LICENSE를 참조하세요.