git-mcp
If you are the rightful owner of git-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This project is a Model Context Protocol (MCP) server designed to interact with Git repositories.
git-mcp
This project is a Model Context Protocol (MCP) server designed to interact with Git repositories. It provides functionality for managing and interacting with Git repositories through MCP tools.
🚀 Features
✅ Git Repository Management: Execute Git operations and manage repositories.
✅ Repository History: View commit history and file changes over time.
✅ File Tracking: Track file changes and view file history.
✅ Diff Operations: View detailed file differences between commits.
📋 Requirements
- Go 1.23.0 or later
- Git installed on your system
- Access to Git repositories
⚙️ Setup
1️⃣ Install the Package
go install github.com/wricardo/git-mcp@latest
2️⃣ Configure MCP Client Settings
Add the following configuration to your MCP settings:
"git-mcp": {
"command": "git-mcp",
"env": {
"WORKDIR": "/path/to/your/git/repository"
},
"disabled": false,
"autoApprove": []
}
▶️ Usage
Run the MCP server:
git-mcp
🛠️ Tools
🔹 git-log
Display git commit history with commit hash, author, date, and message.
📌 Parameters:
limit(optional): Number of commits to display (default: 10)
📌 Example Response:
[
{
"hash": "1234567890abcdef",
"author": "John Doe",
"date": "2024-03-20",
"message": "Initial commit"
}
]
🔹 git-changed-files
List files changed between HEAD and a specified number of commits back.
📌 Parameters:
commits_back(required): Number of commits to look back from HEAD
📌 Example Response:
[
{
"path": "README.md",
"changeType": "modified"
}
]
🔹 git-file-diff
View detailed file differences between commits.
📌 Parameters:
file_path(required): Path to the file to view differencescommits_back(required): Number of commits to look back from HEAD
📌 Example Response:
{
"path": "README.md",
"changes": [
{
"type": "add",
"content": "New line added",
"lineNumber": 42
}
]
}
🔹 git-file-history
View the commit history for a specific file.
📌 Parameters:
file_path(required): Path to the file to view historylimit(optional): Number of commits to display (default: 10)
📌 Example Response:
[
{
"hash": "1234567890abcdef",
"author": "John Doe",
"date": "2024-03-20",
"message": "Update README.md"
}
]
