A
securityA
licenseA
qualityMCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.
Last updated -
22,573
69,516
MIT License
Supports environment variables management through .env files for storing configuration like GitHub tokens securely.
Enables interaction with Git version control system for repository operations, branch management, and commit handling.
Provides a comprehensive API wrapper for GitHub operations, enabling automation and management of repositories, pull requests, issues, branches, commits, and file operations. Includes features for secure token management, merge strategies, status checks, label management, and repository search.
Leverages Python 3.12+ as the implementation language with support for Python virtual environments and package management.
Integrates with Shields.io for generating status badges that display information like Python version and license.
GIT-Pilot
GIT-Pilot is a powerful GitHub automation and management tool that provides a comprehensive API wrapper for GitHub operations. It simplifies GitHub interactions through a FastMCP-based server, making it easy to manage repositories, pull requests, issues, and more.
🌟 Features
🔐 Authentication & Security
Secure token management with encryption using Fernet
Token expiration and automatic cleanup
Rate limit handling and automatic retries
Configurable authentication timeouts
📦 Repository Management
Create and manage repositories
Handle branches and commits
File operations (create, update, delete)
Repository search and filtering
Commit comparison and history
🔄 Pull Request Operations
Create and manage pull requests
Merge strategies (merge, squash, rebase)
Status check validation
Conflict detection and handling
Draft PR support
📝 Issue Management
Create and update issues
Label management
Assignee handling
Comment management
Issue search and filtering
🛠 Technical Features
Thread-safe operations
Resource management
Comprehensive error handling
Detailed logging
Type safety
Configuration management
FastMCP server integration
🚀 Getting Started
Prerequisites
Python 3.12 or higher
GitHub account
GitHub Personal Access Token
FastMCP CLI (optional)
Installation
Clone the repository:
git clone https://github.com/yourusername/GIT-Pilot.git
cd GIT-Pilot
Install uv (if not already installed):
curl -LsSf https://astral.sh/uv/install.sh | sh
Create and activate a virtual environment:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
Install the package using uv:
uv pip install -e .
Set up environment variables: Create a
.envfile in the project root:
GITHUB_TOKEN=your_github_token_here
Basic Usage
Setting Up Claude Desktop Integration
Start the GIT-Pilot server:
uv run main.py
Download and install Claude Desktop
Configure Claude Desktop:
Open Claude Desktop
Go to
File > Settings > Developer > Edit ConfigAdd the following configuration:
{
"mcpServers": {
"GIT-Pilot": {
"command": "uv",
"args": [
"--directory",
"path\\to\\repo",
"run",
"main.py"
]
}
}
}
Restart Claude Desktop
Look for the hammer icon in the chat window - this indicates the MCP server is ready to use
API Examples
# Create a repository
await call_tool("create_repository",
name="my-repo",
description="My awesome repository",
private=True,
has_issues=True,
has_wiki=True,
has_projects=True,
auto_init=True
)
# Create a pull request
await call_tool("create_pull_request",
repo_path="owner/repo",
title="New feature",
head="feature-branch",
base="main",
body="Description of changes",
draft=False
)
# List commits with filtering
await call_tool("list_commits",
repo_path="owner/repo",
branch="main",
author="username",
since="2024-01-01",
until="2024-04-21",
max_results=30
)
🔧 Configuration
The service can be configured through the Config class:
@dataclass
class Config:
TOKEN_TTL_HOURS: int = 24
MAX_STORED_TOKENS: int = 1000
CLEANUP_INTERVAL_SECONDS: int = 3600
MAX_RETRIES: int = 3
RETRY_DELAY_SECONDS: int = 5
MAX_RESULTS_PER_PAGE: int = 100
ENCRYPTION_KEY: bytes = Fernet.generate_key()
🛡 Security
Tokens are encrypted at rest using Fernet
Automatic token expiration and cleanup
Rate limit protection with retries
Input validation
Comprehensive error handling
Secure token cleanup
🔄 Rate Limiting
The service includes built-in rate limit handling:
Automatic retry on rate limit
Configurable retry attempts
Delay between retries
Rate limit status logging
Exponential backoff
🧪 Error Handling
Comprehensive error handling for:
Authentication failures
API errors
Rate limits
Invalid inputs
Resource conflicts
Network issues
Token validation
File operations
📈 Logging
Detailed logging with:
Timestamp
Log level
Function name
Line number
Error details
Stack traces
Rate limit information
Token operations
🤝 Contributing
We welcome contributions! Please follow these steps:
Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Create a Pull Request
📝 License
This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.
🙏 Acknowledgments
PyGithub for the GitHub API wrapper
FastMCP for the server framework
Fernet for secure token encryption
Made with ❤️ by the GIT-Pilot team
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Provides a comprehensive API wrapper for GitHub operations through a FastMCP-based server, simplifying repository management, pull requests, issues, and other GitHub interactions with secure authentication.
Related MCP Servers
- AsecurityFlicenseAqualityMCP Server for the GitHub API, providing features for file operations, repository management, and advanced search, with automatic branch creation and comprehensive error handling.Last updated -1804
- -securityFlicense-qualityProvides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.Last updated -
- AsecurityAlicenseAqualityA MCP server that provides access to GitHub trending repositories and developers data through a simple API interface.Last updated -235MIT License