MCP 服务器

FastMCP GitHub Automation Server

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.

README

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 .env file in the project root:

GITHUB_TOKEN=your_github_token_here

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