Git MCP V2

🚀 Git MCP 服務器

Git MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供了增強型的 Git 操作。通過標準化接口，該服務器與 MCP 生態系統集成，能夠為 AI 助手提供強大的 Git 功能。

🚀 快速開始

若要使用 Git MCP 服務器，您可以按照以下步驟進行操作：

1. 克隆倉庫：

git clone https://github.com/yourusername/git-mcp-v2.git
cd git-mcp-v2

2. 安裝依賴項：

npm install

3. 構建項目：

npm run build

4. 添加到您的 MCP 設置文件中：

{
  "mcpServers": {
    "git-v2": {
      "command": "node",
      "args": ["path/to/git-mcp-v2/build/index.js"],
      "env": {
        "GIT_DEFAULT_PATH": "/path/to/default/git/directory",
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-github-pat"
      }
    }
  }
}

✨ 主要特性

• 核心 Git 操作：支持 init、clone、status、add、commit、push、pull 等核心操作。
• 分支管理：可進行分支列表查看、創建、刪除、切換等操作。
• 標籤操作：支持標籤的列表查看、創建和刪除。
• 遠程管理：能對遠程倉庫進行列表查看、添加和移除操作。
• stash 操作：可進行 stash 列表查看、保存和彈出操作。
• 批量操作：可以按順序執行多個 Git 操作。
• GitHub 集成：通過個人訪問令牌提供內置的 GitHub 支持。
• 路徑解析：具備智能路徑處理能力，還可進行可選的默認路徑配置。
• 錯誤處理：擁有全面的錯誤處理機制，帶有自定義錯誤類型。
• 倉庫緩存：實現了高效的倉庫狀態管理。
• 性能監控：內置了性能跟蹤功能。

📦 安裝指南

克隆倉庫

git clone https://github.com/yourusername/git-mcp-v2.git
cd git-mcp-v2

安裝依賴

npm install

構建項目

npm run build

📚 詳細文檔

環境變量

可用工具

基本操作

• init：初始化新 Git 倉庫
• clone：克隆倉庫
• status：獲取倉庫狀態
• add：階段文件
• commit：創建提交
• push：將提交推送到遠程
• pull：從遠程拉取更改

分支操作

• branch_list：列出所有分支
• branch_create：創建新分支
• branch_delete：刪除分支
• checkout：切換分支或還原工作樹文件

標籤操作

• tag_list：列出標籤
• tag_create：創建標籤
• tag_delete：刪除標籤

遠程操作

• remote_list：列出遠程
• remote_add：添加遠程
• remote_remove：移除遠程

stash 操作

• stash_list：列出 stash
• stash_save：將更改保存到 stash
• stash_pop：應用並刪除 stash

批量操作

• bulk_action：按順序執行多個 Git 操作

開發命令

# 運行測試
npm test

# 帶覆蓋率運行測試
npm run test:coverage

# 運行代碼檢查工具
npm run lint

# 格式化代碼
npm run format

📄 許可證

本項目採用 MIT 許可證。

💡 貢獻指南

1. 叉倉庫
2. 創建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 打開拉取請求