Repo Explorer

🚀 Repo Explorer

Repo Explorer is a powerful tool designed to assist developers in efficiently managing and exploring their code repositories. It offers a variety of features, including repository status checks, code search, and repository cloning, aiming to enhance development efficiency and simplify repository operations.

🚀 Quick Start

Repo Explorer provides a set of useful functions to help developers manage and explore their code repositories. Below are the installation steps and usage examples.

✨ Features

Core Features

• Repository Status Check: Get the latest status information of all repositories.
• Code Pattern Matching: Quickly locate code snippets within a specified scope.
• Repository Structure Creation: Automatically create and manage repository directory structures.
• Incremental Update: Support partial repository cloning and updating to save time and bandwidth.

Technical Advantages

• Multi - level Caching Mechanism: Combine in - memory caching and persistent caching to significantly improve performance.
• Intelligent Pattern Matching: Utilize efficient text - processing algorithms to optimize search speed.
• Version Control Integration: Integrate closely with Git to monitor repository updates in real - time.

📦 Installation

Clone the Repository

git clone https://github.com/yourusername/repo-explorer.git
cd repo-explorer

Install Dependencies

npm install

Build the Tool

npm run build

💻 Usage Examples

Repo Explorer offers the following core tools:

Repository Status Check

<use_mcp_tool>
<server_name>repo-explorer</server_name>
<tool_name>repo_status</tool_name>
<arguments>{}</arguments>
</use_mcp_tool>

Create Repository Structure

<use_mcp_tool>
<server_name>repo-explorer</server_name>
<tool_name>create_reference_repos</tool_name>
<arguments>
{
  "cloneAll": false
}
</arguments>
</use_mcp_tool>

Clone a Specified Repository

<use_mcp_tool>
<server_name>repo-explorer</server_name>
<tool_name>clone_repo</tool_name>
<arguments>
{
  "category": "databases",
  "repo": "watermelondb"
}
</arguments>
</use_mcp_tool>

Search Code Patterns

<use_mcp_tool>
<server_name>repo-explorer</server_name>
<tool_name>search_code</tool_name>
<arguments>
{
  "pattern": "function\\s+\\w+\\s*\\(",
  "filePattern": "*.js",
  "category": "databases",
  "repo": "watermelondb",
  "maxResults": 30,
  "contextLines": 2
}
</arguments>
</use_mcp_tool>

📚 Documentation

Configuration in the Claude Desktop Application

Add the following configuration to the ~/Library/Application Support/Claude/claude_desktop_config.json file:

{
  "mcpServers": {
    "repo-explorer": {
      "command": "node",
      "args": ["/path/to/repo-explorer/build/index.js"],
      "env": {},
      "disabled": false
    }
  }
}

Configuration in the Claude Development Tool (VSCode Extension)

Add the following configuration to the ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json file:

{
  "mcpServers": {
    "repo-explorer": {
      "command": "node",
      "args": ["/path/to/repo-explorer/build/index.js"],
      "env": {},
      "disabled": false
    }
  }
}

🔧 Contribution Guide

Contributions are welcome! Please follow these steps:

1. Fork the repository.
2. Create a feature branch.
3. Commit your changes.
4. Push to the branch.
5. Submit a Pull Request.

📄 License

This project is under the MIT license. For more details, see the LICENSE file.