Integrations
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.
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:
- Install uv (if not already installed):
- Create and activate a virtual environment:
- Install the package using uv:
- Set up environment variables:
Create a
.env
file in the project root:
Basic Usage
Setting Up Claude Desktop Integration
- Start the GIT-Pilot server:
- Download and install Claude Desktop
- Configure Claude Desktop:
- Open Claude Desktop
- Go to
File > Settings > Developer > Edit Config
- Add the following configuration:
- Restart Claude Desktop
- Look for the hammer icon in the chat window - this indicates the MCP server is ready to use
API Examples
🔧 Configuration
The service can be configured through the Config
class:
🛡 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
- AsecurityFlicenseAqualityProvides tools for mapping and analyzing GitHub repositories. It allows users to set a GitHub Personal Access Token and retrieve detailed information about a specified repository, including its structure and summary statistics.Last updated -212TypeScript
- -securityFlicense-qualityEnables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.Last updated -91TypeScript
- -securityFlicense-qualityFacilitates authentication with GitHub using OAuth protocol, allowing secure access and interaction with GitHub repositories and services.Last updated -2Python
- -securityFlicense-qualityEnables interaction with GitHub issues via the Model Context Protocol, allowing users to list and create issues with secure authentication.Last updated -Python