Repo Explorer

基本能力

产品定位

Repo Explorer 是一个专为开发者设计的工具，旨在提供高效的 Git 仓库管理和代码搜索功能，帮助开发者快速定位和分析代码。

核心功能

• 仓库管理：克隆、更新和管理参考仓库
• 高级代码搜索：快速查找跨多个文件的代码模式
• 缓存系统：高效存储搜索结果以提高性能
• 跨仓库分析：比较多个项目中的代码模式
• 可配置的仓库结构：轻松自定义参考仓库
• 平台无关性：支持 macOS、Linux 和 Windows

适用场景

• 开发者在多个 Git 仓库中查找特定代码模式
• 团队需要管理和分析多个参考仓库
• 需要快速比较不同项目中的代码实现

工具列表

• repo_status：获取所有仓库或特定仓库的状态
• clone_repo：克隆特定仓库
• update_repo：更新（拉取）特定仓库
• create_reference_repos：创建参考仓库结构
• search_code：跨仓库搜索代码

常见问题解答

• 如何自定义仓库结构？：编辑 ~/.repo-explorer.json 文件，添加或修改仓库类别和仓库信息。
• 如何提高搜索性能？：利用内置的缓存系统，它会自动存储搜索结果和仓库结构信息。

使用教程

使用依赖

• Node.js 18.x 或更高版本
• Git

安装教程

1. 克隆仓库：

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

1. 安装依赖：

npm install

1. 构建项目：

npm run build

1. 添加到 MCP 配置（参考文档中的“Setup and Configuration”部分）

调试方式

• 使用 repo_status 工具检查仓库状态：

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

• 使用 search_code 工具搜索代码：

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。