agentless-mcp

agentless-mcp ist eine modellfreie strukturelle Maschinerie für Coding-Agenten: eine bedarfsgesteuerte tree-sitter-Repository-Karte auf jeder Zoomstufe (Verzeichnisbaum, Skelett, Zeilenausschnitt), Symbol- und Referenzsuche zur Fehlerlokalisierung sowie deterministisches Parsen, Syntaxprüfung und Kandidatenvalidierung von Patches. Es ruft niemals ein Sprachmodell auf – der aufrufende Agent liefert die gesamte Argumentation, und dieses Werkzeug liefert das Parsen, Ranking, die Enthaltenseinsprüfung und die Verifikation, die er sonst improvisieren würde. Es wird als CLI ausgeliefert, die jeder Agent über Bash aufrufen kann, und als schlanker stdio-MCP-Server über denselben Kern.

Installation

Derzeit über git:

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

Fügen Sie das mcp-Extra für den stdio-Server hinzu (uv tool install "agentless-mcp[mcp] @ git+..."). Eine PyPI-Veröffentlichung folgt; bis dahin ist die git-URL der Installationsweg.

Related MCP server: agentmako

Status

Die Phasen 1 bis 6 sind abgeschlossen. Die CLI und der stdio-MCP-Server sind beide über einen Satz von Anwendungsdiensten live: Repository-Karte, Verzeichnisbaum, Baumgerüst, Ausschnitt, Symbolsuche, Symbolerweiterung, Fan-in, Auflösung von Speicherorten und die aufgelösten Graph-Ansichten – explain (das gestufte Fan-in und Fan-out eines Symbols), path (kürzester aufgelöster Pfad zwischen zwei Symbolen) und cycles (Import-Zyklen auf Modulebene). Die Schreibseite – SEARCH/REPLACE-Patch-Parsing, Syntaxprüfung, worktree-isolierte Anwendung, Kandidatenvalidierung und die äquivalenzgeclusterte Abstimmung – ist nur über die CLI verfügbar und wird nie über MCP bereitgestellt.

Die Referenzauflösung ist deterministisch und modellfrei: Ein Name wird über die eigenen Importe und die eigenen Definitionen der Datei an seine Kandidatendefinitionen gebunden, und jede Kante trägt die diskrete Evidenzstufe, die dahintersteht (gleiche Datei, über Import aufgelöst, eindeutig, nur-Name-mehrdeutig). Der Graph wird bei jedem Aufruf aus dem aktuellen Baum im Speicher zusammengesetzt – nichts davon wird gespeichert, und es gibt keinen Watcher.

Das Parsen erfolgt standardmäßig bei Bedarf; agentless-mcp index baut einen pro-Repository-SQLite-Cache unter $XDG_CACHE_HOME/agentless-mcp/ auf (niemals innerhalb des analysierten Repositorys), der Symbole, Importe und Referenzen für Dateien enthält, deren sha256 sich nicht geändert hat. Jede Antwortquittung nennt die Cache-Generation und ob sie noch die eigene des Repositorys ist, und --no-cache / no_cache: true erzwingt das Parsen bei Bedarf.

Ein Repository kann seine eigenen Standardwerte in einer optionalen .agentless-mcp.json an seiner Wurzel deklarieren (Kartenbudget, maximale Dateien, Granularität, Docstrings, Stopplisten-Ergänzungen und ein test_cmd, das nur die validate-CLI verwendet, nur wenn der Aufruf keine eigenen benannt hat, und nur nachdem es gedruckt wurde). Die Datei ist Repository-Inhalt: Jeder Wert wird schemageprüft und begrenzt, kein Schlüssel ist pfadtypisiert, und unbekannte Schlüssel sind Warnungen im Antwortumschlag und keine Fehler.

Beginnen Sie mit docs/agent-guide.md: Es ist der Verwendungsleitfaden, der für den Agenten geschrieben wurde, der dies aufrufen wird.

Entwicklung

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 ist das Tor – es ist eine strikte Obermenge von ruff, das von Hand ausgeführt wird (es fügt ruff-format, mypy strict, codespell, import-linter und deptry hinzu).

Windows-Unterstützung

Linux und macOS sind die unterstützten Plattformen: Sie sind es, auf denen die Testsuite läuft, und jede Garantie unten wird dort bestätigt. Windows ist dokumentierter Best-Effort – die POSIX-only-Aufrufe haben Windows-Pfade, es gibt kein Windows-CI, und nichts hier wurde auf Windows ausgeführt.

Abgedeckt:

• Die gesamte Leseoberfläche. Karte, Baum, Gerüst, Ausschnitt, Symbolsuche, Fan-in und Speicherortauflösung sind reine Parsing- und Pfadarithmetik, und Pfade gehen über pathlib mit repository-relativen Ergebnissen, die auf Vorwärtsschrägstriche normalisiert werden.

• Der Tag-Cache, einschließlich seiner Single-Writer-Disziplin. Die Indexsperre ist fcntl.flock auf POSIX und msvcrt.locking auf Windows, ausgewählt in util/filelock.py; beide sind nicht blockierend, sodass ein zweiter gleichzeitiger Indexlauf auf beiden Plattformen abgelehnt und nicht in die Warteschlange gestellt wird.

• Patch-Parsing, Syntaxprüfung und der Äquivalenzschlüssel.

Nicht abgedeckt, und der Unterschied ist real:

• Die Timeout-Garantie ist schwächer. Auf POSIX wird eine zeitüberschrittene Testbefehl-Gruppe in ihrer gesamten Prozessgruppe getötet (SIGTERM, dann SIGKILL), sodass alles, was sie erzeugt hat, mit ihr stirbt. Auf Windows wird das Kind mit CREATE_NEW_PROCESS_GROUP erstellt und dann terminate()/kill() nur an den Anführer gesendet: Enkelkinder können einen Timeout überleben. Wenn Ihr Testbefehl einen Server startet, rechnen Sie damit, ihn selbst zu bereinigen.

• Kein Windows-CI. Die Plattform-Dispatch wird auf Linux unit-getestet; die Windows-Systemaufrufe selbst werden nirgendwo ausgeführt.

• Alles, was von git worktree abhängt, verhält sich so, wie es das lokale git tut; es wurde nicht auf Windows-Dateisystemen ausgeführt.

Sicherheit

Die Haltung des Tools gegenüber einem analysierten Repository ist schreibgeschützt und pfadbegrenzt: Die MCP-Oberfläche legt nur Lese-Tools offen, Patch-Anwendung und Testausführung sind CLI-seitig und standardmäßig auf einen isolierten git-Worktree beschränkt, und es wird kein Cache- oder Scratch-Zustand innerhalb des analysierten Repositorys geschrieben.

Eine Einschränkung der Lieferkette ist es wert, im Voraus genannt zu werden. Grammatiken stammen aus tree-sitter-language-pack, das bei der ersten Verwendung ein vorgefertigtes Plattform-Bundle herunterlädt. Diese Bundles werden SHA-256 gegen ein Release-Manifest verifiziert, und eine Abweichung ist ein harter Fehler – aber das Manifest selbst (parsers.json) ist HTTPS-vertrauenswürdig und nicht kryptografisch signiert. Wir akzeptieren dieses Risiko unter exakter Release-Versions-Pinning: tree-sitter und tree-sitter-language-pack werden als Einheit gepinnt und bewegen sich nur durch einen überprüften Bump. Das Abrufen ist auf einen expliziten Warmup-Schritt beschränkt, und sowohl die Manifest-URL als auch das Cache-Verzeichnis sind für gespiegelte oder luftdichte Installationen überschreibbar. Siehe docs/supply-chain-audit.md für das vollständige Audit.

Lizenz

MIT – siehe LICENSE.

Teile dieses Pakets sind abgeleitet von Agentless (MIT, Copyright (c) 2024 OpenAutoCoder): die Zeilenausschnitt-Primitive, die Speicherort-Grammatik, das SEARCH/REPLACE-Bearbeitungsformat und sein Parser sowie die Kandidatenfilter-Leiter und der Abstimmungsschlüssel. NOTICE benennt jede Datei und reproduziert die Upstream-Lizenz.