Repo Explorer

What is Repo Explorer?

Repo Explorer is a Model Context Protocol (MCP) server that provides AI assistants with tools to explore, search, and analyze Git repositories. It is designed for developers who need to reference, compare, and search code patterns across multiple repositories programmatically.

How to use Repo Explorer?

Install Node.js 18+ and Git, then clone the repository, run npm install and npm run build. Add the server to your MCP client configuration (e.g., Claude Desktop or VSCode extension) by specifying the path to build/index.js as a command argument. Configuration is stored in ~/.repo-explorer.json and can be customized to manage your own repository categories and locations.

Key features of Repo Explorer

• Repository management: clone, update, and manage reference repositories
• Advanced code search across multiple files and repositories
• Multi-level caching system for search results and repository structures
• Cross-repository analysis for comparing code patterns
• Configurable repository structure with custom categories
• Platform independent: works on macOS, Linux, and Windows

Use cases of Repo Explorer

• Searching for specific code patterns across a curated set of reference repositories
• Comparing implementation patterns (e.g., state management) across different projects
• Quickly checking the status of cloned repositories and updating them
• Building AI-assisted code analysis workflows that require repository context
• Maintaining a local cache of frequently referenced open-source projects

FAQ from Repo Explorer

What prerequisites are needed to run Repo Explorer?

Node.js 18.x or higher and Git must be installed on the system.

How does the caching system improve performance?

The caching system stores search results and repository structure indexes in memory and on disk, reducing repeated scans. For large repositories (~1GB), search time drops from 35 seconds to 0.2 seconds (99% improvement).

Where are repositories and configuration stored?

By default, repositories are cloned into ~/referencerepos and the configuration file is at ~/.repo-explorer.json. Both can be customized by editing the configuration file.

Which MCP clients are supported?

The server can be used with any MCP client. The README provides specific setup instructions for the Claude Desktop app and the Claude Developer (VSCode) extension.

What tools does Repo Explorer provide?

The server offers six tools: repo_status, clone_repo, update_repo, create_reference_repos, search_code, and a configuration system for managing repositories.