GIT-Pilot

by SiddheshDongare

171 downloads Not rated yet GPL-3.0 license
GitHub

About

A powerful GitHub automation and management tool providing a comprehensive API wrapper for GitHub operations.

Details

License
GPL-3.0 license

Explore

- Thread-safe operations
- Resource management
- Comprehensive error handling
- Detailed logging
- Type safety
- Configuration management
- FastMCP server integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name GIT-Pilot
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Python 3.12 or higher
- GitHub account
- GitHub Personal Access Token
- FastMCP CLI (optional)

- Secure token management with encryption using Fernet
- Token expiration and automatic cleanup
- Rate limit handling and automatic retries
- Configurable authentication timeouts

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()

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "git-pilot": {
            "filesystem": {
                "command": "uv",
                "args": [
                    "--directory",
                    "path\to\repo",
                    "run",
                    "main.py"
                ]
            }
        }
    }
}

McpServers

{
    "filesystem": {
        "command": "uv",
        "args": [
            "--directory",
            "path\to\repo",
            "run",
            "main.py"
        ]
    }
}

<div align="center">
GIT-Pilot Logo
</div>

Python Version
License
GitHub

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

1. Clone the repository:

git clone https://github.com/yourusername/GIT-Pilot.git
cd GIT-Pilot

2. Install uv (if not already installed):

curl -LsSf https://astral.sh/uv/install.sh | sh

3. Create and activate a virtual environment:

uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate

4. Install the package using uv:

uv pip install -e .

5. Set up environment variables:
Create a .env file in the project root:

GITHUB_TOKEN=your_github_token_here

API Examples

```python

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.