[pgr は、コード検索用の実験的でステートレスな MCP サーバーで、 コーディングエージェントの検索リポジトリに関する研究

洗練された製品ではなく、作業プロトタイプと公共の研究アーティファクトです。

エージェント用に設計されたランキングと出力シェーピングでローカルコード検索をラップ ワークフロー: 実装ファイルを先にサーフィンする可能性が高い, 開発テスト そして、低値のマッチと結果のフォーマットは、モデルが読み方を決定することができます 次は、より少ない発疹で。

このリポジトリには、パブリックデータセット、ベンチマークパッケージ、保存が含まれます。 エージェントのコード検索に付随する書き込みで使用される結果。

• クイックスタート
• 使用法の文書
• パブリックベンチマークとデータ
• 投稿ガイド
• セキュリティポリシー
• ライセンス

クイックスタート

##1. pgrをインストール

このリポジトリから[pgrをインストールします。

##2. MCPクライアントに追加する

その後、stdioサーバーを起動できるMCPクライアントに追加します。

##3. 検索するリポジトリでそれをポイントする

エージェントが検索したいリポジトリに[[cwd]を設定します。 [[pgr]]は検索します。 起動するプロセスの現在の作業ディレクトリ。

##4. エージェントに検索を依頼する

設定したら、エージェントにリポを検索してください。 例えば:

pgr

pgr is an experimental, stateless MCP server for code search, built as part of research into how coding agents search repositories.

It is a working prototype and public research artifact, not a polished product.

It wraps local code search with ranking and output shaping designed for agent workflows: surfacing likely implementation files earlier, de-prioritizing tests and low-value matches, and formatting results so a model can decide what to read next with less thrashing.

This repository also includes the public datasets, benchmark packages, and saved results used in the accompanying writeup on agentic code search.

• Quick Start
• Usage Documentation
• Public Benchmarks and Data
• Contributing guide
• Security policy
• License

Quick Start

1. Install pgr

Install pgr from this repository:

git clone https://github.com/entireio/pgr.git
cd pgr
cargo install --path .

2. Add it to your MCP client

Then add it to any MCP client that can launch a stdio server:

{
  "mcpServers": {
    "pgr": {
      "command": "pgr",
      "cwd": "/absolute/path/to/repo"
    }
  }
}

3. Point it at the repo to search

Set cwd to the repository you want your agent to search. pgr searches the current working directory of the process that launches it.

4. Ask your agent to search

Once configured, ask your agent to search the repo. For example:

search for where checkpoint commits are written

find the code that handles MCP tool calls

If pgr is not yet on your shell PATH after install, use the binary directly at:

~/.cargo/bin/pgr

What pgr gives agents

pgr is not trying to replace ripgrep. It shells out to local rg for fast content search and file listing, then ranks and shapes the results for coding agents.

That means an agent is more likely to see implementation files before test noise, repeated references, or lower-signal matches.

At a high level it provides tools for:

• search_code
• read_code
• find_files
• list_dir

The search output profile is controlled with PGR_OUTPUT_PROFILE. If it is unset, the server defaults to the richer planner-oriented output profile used in the public results.

There is no index to build, no background daemon, and no separate storage layer. pgr starts, answers MCP tool calls over stdio, and exits when the client stops it.

Build from source

cargo build --release

The binary will be available at target/release/pgr.

If you want the binary on your PATH, you can also install it locally with:

cargo install --path .

For most first-time users, this is the easiest way to try pgr.

Requirements

• Rust toolchain for building from source
• ripgrep installed and available as