Skip to main content
Glama
mcp-repo-search

mcp-repo-search

MCP Repo Search

MCP server that clones a Git repo into a temp directory so Cursor (or other MCP clients) can search and read files from another repo for context. The clone is removed automatically after 5 minutes of inactivity.

Requirements

  • Node.js 18+

  • Git installed and on PATH

  • MCP host (e.g. Cursor)

Related MCP server: Gitingest-MCP

Install

Option A – From npm (recommended if you published the package):

# Global install (anyone can use it)
npm install -g mcp-repo-search

Option B – With npx (no install; runs from npm cache):

No install. Use npx mcp-repo-search in Cursor config below.

Option C – From source (clone this repo):

cd mcp-repo-search
npm install
npm run build

Cursor configuration

If you installed globally or use npx, add to your MCP config (e.g. .cursor/mcp.json or Cursor Settings → MCP):

{
  "mcpServers": {
    "repo-search": {
      "command": "npx",
      "args": ["mcp-repo-search"]
    }
  }
}

Or with global install:

{
  "mcpServers": {
    "repo-search": {
      "command": "mcp-repo-search"
    }
  }
}

If you use a local clone, use the absolute path to the built entry point:

{
  "mcpServers": {
    "repo-search": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-repo-search/build/index.js"]
    }
  }
}

Example path on macOS/Linux: /Users/you/projects/multi-repo-mcp/mcp-repo-search/build/index.js


Tools

Tool

Description

ensure_repo

Clone a repo (or reuse existing clone). Call this first with repoUrl (and optional branch). Resets the idle timer.

get_repo_status

Whether a repo is cloned, its path, URL, and idle TTL. Does not clone.

read_file

Read a file from the clone (path relative to repo root). Max 512 KB. Resets timer.

list_directory

List files and dirs under a path (default "."). Resets timer.

search_repo

Text/regex search in the clone. Optional path and fileGlob (e.g. *.ts). Resets timer.

Typical flow: run ensure_repo with the repo URL, then use search_repo, read_file, or list_directory to pull context.

Environment (optional)

  • MCP_REPO_SEARCH_TTL_SECONDS – Idle timeout in seconds before the clone is deleted (default: 300, i.e. 5 minutes).

  • MCP_REPO_SEARCH_TEMP_DIR – Base directory for clones (default: os.tmpdir()/mcp-repo-search).

Private repos

Git auth is not handled by this server. For private repos, rely on system Git config (e.g. credential helper, SSH keys, or GIT_ASKPASS). Clone is done with a shallow --depth 1 and optional --branch.

Logging

The server logs to stderr only (stdout is used for MCP JSON-RPC). Check your MCP client’s server logs (e.g. Cursor’s MCP server log) for errors.

Available Tools

5 tools
ensure_repoA

Clone a Git repo to a temp directory (or reuse existing clone). Call this first before search_repo, read_file, or list_directory. Returns the clone path and status. Resets the 5-minute idle timer.

Inputs: repoUrl (required), branch.

get_repo_statusA

Returns whether a repo is currently cloned, its path, repo URL, and seconds until expiry. Does not clone; call ensure_repo first if needed.

Inputs: no named parameters.

list_directoryA

List files and directories in the cloned repo. Path is relative to repo root (default "."). Call ensure_repo first. Resets idle timer.

Inputs: path.

read_fileA

Read a file from the cloned repo. Path is relative to repo root. Call ensure_repo first. Resets idle timer.

Inputs: path (required).

search_repoA

Search for text or regex in the cloned repo. Optional path (subdir) and fileGlob (e.g. *.ts). Call ensure_repo first. Resets idle timer.

Inputs: query (required), path, fileGlob.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: cloning, checking status, reading a file, listing a directory, and searching. ensure_repo and get_repo_status are related but one performs an action while the other reports state, so no ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (ensure_repo, get_repo_status, read_file, list_directory, search_repo), using snake_case throughout. This makes the set predictable and easy to navigate.

    Tool Count5/5

    Five tools is well-scoped for a repo search server: one setup action, one status query, and three core read/search operations. Each tool earns its place, and the count is within the ideal 3-15 range.

    Completeness5/5

    The tool surface provides complete lifecycle coverage for the stated purpose of searching within a cloned repo. It supports cloning (with reuse), checking cached state, reading individual files, listing directories, and searching by text/regex—no obvious gaps for this read-only domain.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP clients such as Claude Desktop, Cline, and Cursor to quickly extract information about GitHub repositories, including repository summaries, project directory structures, and file contents.
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP clients to extract GitHub repository summaries, project directory structures, and file contents for quick inspection and use in tools like Claude Desktop, Cline, and Cursor.
      -