pgr는 실험적이고, 상태 없는 MCP 서버로 코드 검색, 일부로 구축 코딩 에이전트 검색 저장소에 대한 연구.

그것은 작업 프로토 타입 및 공공 연구 Artifact, 광택이 없는 제품입니다.

그것은 에이전트를 위해 설계 된 순위 및 출력 셰이핑과 로컬 코드 검색을 포장 워크플로우: surfacing 가능성 구현 파일 이전, de-prioritizing 테스트 그리고 낮은 가치 경기, 및 포맷 결과 그래서 모델은 읽는 것을 결정할 수 있습니다 더 적은 thrashing와 함께.

이 저장소에는 공공 데이터 세트, 벤치 마크 패키지 및 저장이 포함됩니다. Agentic 코드 검색에 동호 작성에 사용 된 결과.

• 빠른 시작
• 사용 서류
• 공공 벤치 마크 및 데이터
• 수집방법
• 보안 정책
• 라이센스

빠른 시작

##1. pgr 설치

이 저장소에서 pgr 설치:

##2. MCP 클라이언트에 추가

그런 다음 stdio 서버를 시작할 수있는 MCP 클라이언트에 추가하십시오.

##3. 검색하기 위해 repo에서 포인트

cwd]를 검색하기 위해 에이전트를 원하는 저장소에 설정합니다. pgr 검색 실행 프로세스의 현재 작업 디렉토리.

##4. 귀하의 에이전트를 검색

구성되면, 당신의 대리인에게 repo를 검색하십시오. 예를 들면:

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