Git Repository Browser

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

MCP Git 倉庫瀏覽器是一個基於 Node.js 的工具，藉助模型上下文協議 (MCP)，可實現對 Git 倉庫的便捷瀏覽與操作。

🚀 快速開始

安裝完成後，在終端中運行：

git-commands-mcp --help

即可查看所有可用命令和選項。

✨ 主要特性

該服務器提供以下工具：

基本倉庫操作

1. git_directory_structure：返回倉庫目錄結構的樹狀表示

   • 輸入：倉庫 URL
   • 輸出：ASCII 樹狀表示的倉庫結構

2. git_read_files：讀取並返回指定文件的內容

   • 輸入：倉庫 URL 和文件路徑列表
   • 輸出：文件路徑到內容的字典映射

3. git_search_code：在倉庫代碼中搜索

   • 輸入：倉庫 URL、搜索詞和可選參數（如大小限制）
   • 輸出：匹配文件的內容列表

項目結構

- src/
  - index.js：入口點
  - utils/
    - gitOperations.js：Git 操作工具
  - config/
    - settings.json：默認配置

📦 安裝指南

通過 npm（推薦）

npm install -g git-commands-mcp

手動安裝

git clone https://github.com/bsreeram08/git-commands-mcp.git
cd git-commands-mcp
npm install

📚 詳細文檔

配置

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

{
  "mcpServers": {
    "git-commands-mcp": {
      "command": "git-commands-mcp"
    }
  }
}

對於手動安裝，請使用：

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

🔧 技術細節

• 使用 Node.js 構建，提供高效的倉庫操作
• 支持多平臺兼容性
• 提供詳細的錯誤處理和日誌記錄

需求

• Node.js v14 或更高版本
• Git 2.0 或更高版本
• npm v6 或更高版本

📄 許可證

MIT License - 請參閱 LICENSE 文件瞭解詳細信息。

🔗 鏈接

• GitHub 倉庫
• NPM 包
• 報告問題