MCP Git Tools

🚀 MCP Git Tool

MCP Git is a powerful tool designed to simplify interactions with Git repositories. It offers a variety of commands that enable users to perform common Git operations such as committing, pulling, pushing, resetting, etc.

✨ Features

• git commit: Create a new commit.
• git pull: Fetch the latest changes from a remote repository.
• git push: Push local changes to a remote repository.
• git reset: Reset to a specified commit or branch.
• git diff: View differences between files.
• git add: Add files to the staging area.
• git restore: Revert changes to files.

📦 Installation

To use the MCP Git tool, follow these installation steps:

1. Download the tool package.
2. Extract the files and add them to the system path.

💻 Usage Examples

Run as an Independent Server

# Clone the repository
git clone https://github.com/username/repository.git

# Navigate to the repository directory
cd repository

# Commit changes
git commit -m "Commit message"

# Push changes
git push origin main

Use in the MCP Client

# Initialize the client
client = GitClient(path_to_repository)

# Add files to the staging area
client.add("file1.txt")

# Commit changes
commit_info = client.commit(message="Commit message")

# Pull the latest changes
pull_result = client.pull()

# Push changes
push_result = client.push(remote="origin", branch="main")

Integrate into a Custom Server

// Initialize the Git repository
Git git = Git.init();

// Add files
git.add().addFilepattern("file1.txt").call();

// Commit changes
git.commit().setMessage("Commit message").call();

// Pull the latest changes
git.pull().setRemoteName("origin").setBranchName("main").call();

📚 Documentation

git commit

Function: Create a new commit.
Parameters:

• repo_path: Repository path.
• message: Commit message.
• all: Whether to automatically stage all modified files (optional, default is false).

Return value:

{
  "success": true,
  "hash": "abcd1234",
  "message": "feat: Add new feature"
}

git pull

Function: Fetch the latest changes from a remote repository.
Parameters:

• repo_path: Repository path.
• remote: Remote name (optional, default is "origin").
• branch: Branch name (optional, default is the current branch).

Return value:

{
  "success": true,
  "remote": "origin",
  "output": "Update completed"
}

git push

Function: Push local changes to a remote repository.
Parameters:

• repo_path: Repository path.
• remote: Remote name (optional, default is "origin").
• branch: Branch name (optional, default is the current branch).
• force: Whether to force push (optional, default is false).

Return value:

{
  "success": true,
  "remote": "origin",
  "output": "Pushed to the remote repository successfully"
}

git reset

Function: Reset files or the staging area to a specified state.
Parameters:

• repo_path: Repository path.
• path: The file or path to reset (optional, default is the current directory).
• hard: Whether to perform a hard reset (warning: all local changes will be lost) (optional, default is false).

Return value:

{
  "success": true,
  "message": "Files have been reset"
}

git diff

Function: Show differences between specified files.
Parameters:

• repo_path: Repository path.
• file_name: The name of the file to view differences.

Return value:

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

git add

Function: Add files to the staging area.
Parameters:

• repo_path: Repository path.
• file_name: The name of the file to add.

Return value:

{
  "success": true,
  "message": "Files have been added to the staging area"
}

📄 License

The MCP Git tool is licensed under the MIT License, which allows users to freely use, modify, and distribute the tool.