Git Repo Browser

🚀 MCP Git 倉庫瀏覽器（Node.js）

MCP Git 倉庫瀏覽器是一個基於 Node.js 實現的工具，藉助 Model Context Protocol (MCP)，可幫助用戶輕鬆瀏覽 Git 倉庫。

🚀 快速開始

若要使用 MCP Git 倉庫瀏覽器，你需要先完成配置和安裝，再啟動服務器。以下是具體步驟：

配置

將以下內容添加到您的 MCP 設置配置文件中：

{
    "mcpServers": {
        "mcp-git-repo-browser": {
            "command": "node",
            "args": ["/path/to/mcp-git-repo-browser/src/index.js"]
        }
    }
}

安裝

git clone <repository-url>
cd mcp-git-repo-browser
npm install

啟動服務器

node src/index.js

該服務器通過標準輸入輸出運行，使其與 MCP 客戶端兼容。

✨ 主要特性

該服務器提供兩個主要工具：

1. git_directory_structure：返回倉庫目錄結構的樹狀表示
   • 輸入：倉庫 URL
   • 輸出：ASCII 樹狀表示，顯示倉庫目錄結構
2. git_read_important_files：讀取並返回指定文件的內容
   • 輸入：倉庫 URL 和文件路徑列表
   • 輸出：文件路徑到內容的字典映射

🔧 技術細節

• 使用 Node.js 原生模塊（crypto、path、os）實現核心功能
• 利用 fs-extra 進行增強型文件操作
• 採用 simple-git 進行 Git 倉庫操作
• 實現了乾淨的錯誤處理和資源清理
• 根據倉庫 URL 的哈希創建確定性臨時目錄
• 在可能的情況下重用已克隆的倉庫以提高效率

📄 許可證

本項目採用 MIT License，詳見 LICENSE 文件獲取詳細信息。

📦 安裝要求

• Node.js 14.x 或更高版本
• 系統上安裝 Git