poly-git-mcp

Unified MCP server for Git forge management. Provides Model Context Protocol tools for interacting with GitHub, GitLab, Gitea, and Bitbucket through their respective CLI tools and APIs.

Table of Contents

• Overview
• Adapters
  • GitHub (13 tools)
  • GitLab (12 tools)
  • Gitea (11 tools)
  • Bitbucket (10 tools)
• Requirements
• Configuration
  • Bitbucket Authentication
• Installation
• Usage
• License

Overview

poly-git-mcp exposes Git forge capabilities through the Model Context Protocol (MCP), enabling AI assistants and other MCP clients to manage repositories, issues, pull requests, and CI/CD across multiple Git platforms.

Adapters

GitHub (13 tools)

GitHub via gh CLI:

• gh_repo_list - List repositories

• gh_repo_view - View repository details

• gh_repo_clone - Clone a repository

• gh_issue_list - List issues

• gh_issue_view - View an issue

• gh_issue_create - Create an issue

• gh_pr_list - List pull requests

• gh_pr_view - View a pull request

• gh_pr_create - Create a pull request

• gh_pr_merge - Merge a pull request

• gh_release_list - List releases

• gh_workflow_list - List workflow runs

• gh_auth_status - Check authentication status

GitLab (12 tools)

GitLab via glab CLI:

• glab_project_list - List projects

• glab_project_view - View project details

• glab_issue_list - List issues

• glab_issue_view - View an issue

• glab_issue_create - Create an issue

• glab_mr_list - List merge requests

• glab_mr_view - View a merge request

• glab_mr_create - Create a merge request

• glab_mr_merge - Merge a merge request

• glab_pipeline_list - List pipelines

• glab_ci_status - Show CI/CD status

• glab_auth_status - Check authentication status

Gitea (11 tools)

Gitea/Forgejo via tea CLI:

• tea_repo_list - List repositories

• tea_repo_view - View repository details

• tea_issue_list - List issues

• tea_issue_view - View an issue

• tea_issue_create - Create an issue

• tea_pr_list - List pull requests

• tea_pr_view - View a pull request

• tea_pr_create - Create a pull request

• tea_release_list - List releases

• tea_org_list - List organizations

• tea_login_list - List configured logins

Bitbucket (10 tools)

Bitbucket via REST API:

• bb_repo_list - List repositories

• bb_repo_view - View repository details

• bb_issue_list - List issues

• bb_pr_list - List pull requests

• bb_pr_view - View a pull request

• bb_pipeline_list - List pipelines

• bb_branches - List branches

• bb_commits - List commits

• bb_workspaces - List workspaces

• bb_user - Get current user info

Requirements

• Deno runtime

• GitHub CLI (gh) (for GitHub tools)

• GitLab CLI (glab) (for GitLab tools)

• tea (for Gitea tools)

• Bitbucket app password (for Bitbucket tools)

Configuration

Bitbucket Authentication

Set environment variables for Bitbucket API access:

export BITBUCKET_USERNAME=your-username
export BITBUCKET_APP_PASSWORD=your-app-password

Create an app password at: https://bitbucket.org/account/settings/app-passwords/

Installation

git clone https://github.com/hyperpolymath/poly-git-mcp
cd poly-git-mcp
npm install
npm run build

Usage

Run as MCP server:

deno run --allow-run --allow-read --allow-env --allow-net main.js

Or use the systemd service:

systemctl --user enable poly-git-mcp
systemctl --user start poly-git-mcp

License

MIT