A Model Context Protocol (MCP) server that provides AI assistants with access to Gitblit-hosted Git repositories.

Warning

This project is experimental and provided as-is. Use at your own risk.

This MCP server requires the GitblitMCPSupportPlugin to be installed on your Gitblit instance.

Important architectural note: This Python-based MCP server exists as a proof-of-concept. The recommended long-term approach would be to integrate MCP support directly into Gitblit's Java codebase using a Java MCP SDK. This would eliminate the need for a separate service and provide a more maintainable solution. This project may be deprecated if native MCP support is added to Gitblit.

Gitblit MCP Server is a thin protocol adapter that translates MCP tool calls into HTTP requests to the GitblitMCPSupportPlugin. It enables AI assistants to:

• Browse repositories: List and search available repositories
• Navigate files: Browse directory structures and list files
• Read content: Access file contents with line range and revision support
• Search code: Full-text search across file contents using Lucene
• Search commits: Query commit history by message and metadata

• Gitblit instance with GitblitMCPSupportPlugin installed
• Python 3.10+ (for local installation) or Docker

docker build -t gitblit-mcp-server .
docker run -d \
  -e GITBLIT_URL=http://your-gitblit-host:8080 \
  -p 8000:8000 \
  gitblit-mcp-server

# Clone the repository
git clone https://github.com/pvginkel/GitblitMCPServer.git
cd GitblitMCPServer

# Install dependencies
poetry install

# Configure
cp .env.example .env
# Edit .env with your settings

# Run
poetry run python -m gitblit_mcp_server

Configure via environment variables or a .env file:

┌─────────────────┐     MCP Protocol      ┌─────────────────────┐
│   MCP Client    │◄────────────────────►│  Gitblit MCP Server │
│  (AI Assistant) │                       │       (Python)      │
└─────────────────┘                       └──────────┬──────────┘
                                                     │ HTTP/JSON
                                                     ▼
                                          ┌─────────────────────┐
                                          │ GitblitMCPSupport   │
                                          │      Plugin         │
                                          └──────────┬──────────┘
                                                     │
                                                     ▼
                                          ┌─────────────────────┐
                                          │      Gitblit        │
                                          │  (Git Repositories) │
                                          └─────────────────────┘

# Run tests (requires configured Gitblit instance)
poetry run pytest

# Lint
poetry run ruff check .

# Type check
poetry run mypy src

See LICENSE file for details.

• GitblitMCPSupportPlugin - Required Gitblit plugin providing the REST API backend