mcp-repo-search
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-repo-search search for 'TODO' in https://github.com/example/repo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
PATHMCP 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-searchOption 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 buildCursor 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 |
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 |
search_repo | Text/regex search in the clone. Optional |
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 toolsensure_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
Scored across 5 tools
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.
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.
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.
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
Search, inspect and inject full source modules (code + AI rules + MCP) pinned to a Git commit.
Cache source-backed repository context so coding agents can reuse knowledge across sessions.
Code intelligence for LLMs. Analyze, search, and retrieve code from any public git repository.
Repo intel for AI coding agents: overview, PRs, contributors, hot files, CI, deps. Remote MCP.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceEnables 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.-
- FlicenseNot gradedqualityAmaintenanceEnables 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.-
- FlicenseNot gradedqualityAmaintenanceEnables MCP clients to quickly extract information about GitHub repositories, including repository summaries, project directory structure, and file content.-
- FlicenseNot gradedqualityAmaintenanceEnables MCP clients such as Claude Desktop, Cline, and Cursor to quickly extract GitHub repository summaries, project directory structures, and file contents.-