MCP Git Tools

🚀 MCP Git 工具

MCP Git 是一款功能強大的工具，它能極大簡化與 Git 倉庫的交互過程。藉助它提供的一系列命令，用戶可以輕鬆執行常見的 Git 操作，如提交、拉取、推送、重置等，提升工作效率。

🚀 快速開始

MCP Git 工具旨在簡化與 Git 倉庫的交互，讓你輕鬆執行常見的 Git 操作。

✨ 主要特性

• git 提交：創建新的提交。
• git 拉取：從遠程倉庫獲取最新更改。
• git 推送：將本地更改推送到遠程倉庫。
• git 重置：重置到指定的提交或分支。
• git 差異顯示：查看文件之間的差異。
• git 添加：將文件添加到暫存區。
• git 恢復：取消對文件的修改。

📦 安裝指南

要使用 MCP Git 工具，請按照以下步驟進行安裝：

1. 下載工具包。
2. 解壓文件並添加到系統路徑中。

💻 使用示例

基礎用法

作為獨立服務器運行

# 克隆倉庫
git clone https://github.com/username/repository.git

# 進入倉庫目錄
cd repository

# 提交更改
git commit -m "提交信息"

# 推送更改
git push origin main

在 MCP 客戶端中使用

# 初始化客戶端
client = GitClient(path_to_repository)

# 添加文件到暫存區
client.add("file1.txt")

# 提交更改
commit_info = client.commit(message="提交信息")

# 拉取最新更改
pull_result = client.pull()

# 推送更改
push_result = client.push(remote="origin", branch="main")

集成到自定義服務器中

// 初始化 Git 倉庫
Git git = Git.init();

// 添加文件
git.add().addFilepattern("file1.txt").call();

// 提交更改
git.commit().setMessage("提交信息").call();

// 拉取最新更改
git.pull().setRemoteName("origin").setBranchName("main").call();

高級用法

本工具在不同場景下的使用已在基礎用法中詳細展示，若有更復雜的定製需求，可根據工具詳細說明中的參數進行靈活調整。

📚 詳細文檔

git 提交

功能: 創建一個新的提交。
參數:

• repo_path: 倉庫路徑。
• message: 提交信息。
• all: 是否自動暫存所有修改文件（可選，默認為 false）。

返回值:

{
  "success": true,
  "hash": "abcd1234",
  "message": "feat: 添加新功能"
}

git 拉取

功能: 從遠程倉庫拉取最新更改。
參數:

• repo_path: 倉庫路徑。
• remote: 遠程名稱（可選，默認為 "origin"）。
• branch: 分支名稱（可選，默認為當前分支）。

返回值:

{
  "success": true,
  "remote": "origin",
  "output": "更新完成"
}

git 推送

功能: 將本地更改推送到遠程倉庫。
參數:

• repo_path: 倉庫路徑。
• remote: 遠程名稱（可選，默認為 "origin"）。
• branch: 分支名稱（可選，默認為當前分支）。
• force: 是否強制推送（可選，默認為 false）。

返回值:

{
  "success": true,
  "remote": "origin",
  "output": "推送到遠程倉庫成功"
}

git 重置

功能: 將文件或暫存區重置到指定狀態。
參數:

• repo_path: 倉庫路徑。
• path: 要重置的文件或路徑（可選，默認為當前目錄）。
• hard: 是否執行硬重置（警告：會丟失所有本地更改）（可選，默認為 false）。

返回值:

{
  "success": true,
  "message": "文件已重置"
}

git 差異顯示

功能: 顯示指定文件的差異。
參數:

• repo_path: 倉庫路徑。
• file_name: 要查看差異的文件名。

返回值:

{
  "diff": "+ 行1\n- 行2"
}

git 添加

功能: 將文件添加到暫存區。
參數:

• repo_path: 倉庫路徑。
• file_name: 要添加的文件名。

返回值:

{
  "success": true,
  "message": "文件已添加到暫存區"
}

📄 許可證

MCP Git 工具遵循 MIT 許可證，允許用戶自由使用、修改和分發該工具。