Repo Explorer

🚀 倉庫資源管理器探索者

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

貢獻指南

歡迎貢獻！請按照以下步驟操作：

1. Fork 倉庫
2. 創建功能分支
3. 提交更改
4. 推送到分支
5. 提交 Pull Request

📄 許可證

本項目採用 MIT 許可證，詳細信息見 LICENSE 文件。