agentless-mcp

agentless-mcp は、コーディングエージェントのためのモデルフリーな構造的機構です。任意のズームレベルでのオンデマンドな tree-sitter リポジトリマップ(ディレクトリツリー、スケルトン、行スライス)、バグの特定のためのシンボルおよび参照ルックアップ、そして決定的なパッチ解析、構文チェック、候補検証を提供します。言語モデルを呼び出すことは決してありません。呼び出し側のエージェントがすべての推論を提供し、このツールは、エージェントがそうでなければ即興で行うであろう解析、ランキング、包含、検証を提供します。これは、任意のエージェントが Bash 経由で呼び出せる CLI として、また同じコア上に構築された薄い 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(1つのシンボルの階層化されたファンインとファンアウト)、path(2つのシンボル間の最短解決パス)、cycles(モジュールレベルのインポートサイクル)。書き込み側 — SEARCH/REPLACE パッチ解析、構文チェック、ワークツリー分離適用、候補検証、等価クラスタリング投票 — は CLI 専用であり、MCP 上では決して公開されません。

参照解決は決定的かつモデルフリーです。名前は、ファイル自身のインポートと自身の定義を通じて候補定義にバインドされ、すべてのエッジはその背後にある離散的なエビデンス階層(same-file、resolved-via-import、unique、name-only-ambiguous)を保持します。グラフは呼び出しのたびに現在のツリーからメモリ内で組み立てられます。それについて何も保存されず、ウォッチャーもありません。

解析はデフォルトではオンデマンドで行われます。agentless-mcp index は、sha256 が変更されていないファイルのシンボル、インポート、参照を保持する、リポジトリごとの SQLite キャッシュを $XDG_CACHE_HOME/agentless-mcp/ の下に構築します(解析対象リポジトリの内部には決して作成しません)。すべての回答のレシートは、キャッシュ世代と、それがまだリポジトリ自身のものであるかどうかを示し、--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 で選択されます。どちらも非ブロッキングなので、2 番目の並行インデックス実行は、どちらのプラットフォームでもキューに入れられるのではなく拒否されます。

• パッチ解析、構文チェック、等価キー。

対象外(その違いは現実のものです):

• タイムアウトの保証は弱くなります。 POSIX では、タイムアウトしたテストコマンドはプロセスグループ全体が強制終了されます(SIGTERM、その後 SIGKILL)。そのため、コマンドが生成したものはすべて一緒に終了します。Windows では、子プロセスは CREATE_NEW_PROCESS_GROUP で作成され、その後 terminate()/kill() がリーダーにのみ送信されます: 孫プロセスはタイムアウト後も生存できます。テストコマンドがサーバーを起動する場合は、自分でクリーンアップする必要があります。

• Windows CI はありません。 プラットフォームのディスパッチは Linux 上でユニットテストされていますが、Windows のシステムコール自体はどこでも実行されていません。

• git worktree に依存するものはすべて、ローカルの git と同じように動作します。Windows ファイルシステム上では実行されていません。

セキュリティ

このツールの解析対象リポジトリに対する姿勢は読み取り専用かつパス制限付きです。MCP サーフェスは読み取りツールのみを公開し、パッチ適用とテスト実行は CLI 側にあり、デフォルトで分離された git ワークツリーを使用します。また、解析中のリポジトリ内にキャッシュやスクラッチ状態は書き込まれません。

サプライチェーンに関する注意点を 1 つ最初に述べておく価値があります。グラマーは tree-sitter-language-pack から取得され、初回使用時にプリビルドされたプラットフォームバンドルをダウンロードします。これらのバンドルはリリースマニフェストに対して SHA-256 で検証され、不一致は重大な失敗となります。ただし、マニフェスト自体(parsers.json)は暗号署名ではなく HTTPS で信頼されています。私たちは、厳密なリリースバージョンのピン留めの下でこのリスクを受け入れます: tree-sitter と tree-sitter-language-pack はユニットとしてピン留めされ、レビュー済みのバンプを通じてのみ移動します。フェッチは明示的なウォームアップステップに限定され、マニフェスト URL とキャッシュディレクトリの両方は、ミラーリングまたはエアギャップ環境でのインストール用にオーバーライド可能です。完全な監査については docs/supply-chain-audit.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。

このパッケージの一部は Agentless (MIT, Copyright (c) 2024 OpenAutoCoder) から派生しています: 行スライスプリミティブ、ロケーショングラマー、SEARCH/REPLACE 編集形式とそのパーサー、候補フィルターラダーと投票キー。NOTICE は各ファイルを指定し、上流のライセンスを再掲しています。