JinDaGe - repo-explorer MCP Details

article

README

🚀 仓库资源管理器探索者

Repo Explorer 是一款强大的工具，能助力开发者高效管理和探索代码仓库。它提供了仓库状态检查、代码搜索、仓库克隆等功能，可有效提升开发效率，简化仓库操作流程。

🚀 快速开始

Repo Explorer 能帮助开发者轻松管理和探索代码仓库，按以下步骤操作即可快速上手。

✨ 主要特性

核心特性

仓库状态检查：可获取所有仓库的最新状态信息。
代码模式匹配：能在指定范围内快速定位代码片段。
仓库结构创建：可自动化创建和管理仓库目录结构。
增量式更新：支持部分仓库克隆和更新，节省时间与带宽。

技术优势

多级缓存机制：结合内存缓存和持久化缓存，显著提升性能。
智能模式匹配：利用高效的文本处理算法优化搜索速度。
版本控制集成：与 Git 紧密结合，实时监控仓库更新。

📦 安装指南

克隆仓库

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

安装依赖

npm install

构建工具

npm run build

💻 使用示例

基础用法

Repo Explorer 提供了以下核心工具，可按示例进行操作。

仓库状态检查

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

创建仓库结构

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

克隆指定仓库

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

搜索代码模式

<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>

📚 详细文档

配置指南

在 Claude 桌面应用中配置

在 ~/Library/Application Support/Claude/claude_desktop_config.json 文件中添加如下配置：

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

在 Claude 开发工具（VSCode 插件）中配置

在 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 文件中添加如下配置：

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

贡献指南

欢迎贡献！请按照以下步骤操作：

Fork 仓库
创建功能分支
提交更改
推送到分支
提交 Pull Request

📄 许可证

本项目采用 MIT 许可证，详细信息见 LICENSE 文件。

repo-explorer