mcp-registry/git-mcp

    ==================
      
       /// MCP ///
      /// GIT ///
        
    ==================
        
    [server:online]
    [protocol:ready]

git-mcp

by idosal

GitMCP is a free, open-source Model Context Protocol (MCP) server that turns any GitHub repository or GitHub-Pages site into an AI-readable documentation hub, eliminating code-hallucinations in tools such as Cursor, VSCode, Claude Desktop, etc.

3.7k
259
Open Source

01

fetch_<repo-name>_documentation

Retrieve the primary documentation of a specific GitHub repository to give the AI an overview of the project.

02

search_<repo-name>_documentation

Search within a repository’s documentation for passages relevant to a given query.

03

fetch_url_content

Fetch and convert the content of external links referenced in documentation into an AI-readable format.

04

search_<repo-name>_code

Search the repository’s source code via GitHub code search to locate examples or implementation details.

05

fetch_generic_documentation

(Dynamic endpoint) Retrieve primary documentation for any repository specified at call time.

06

search_generic_code

(Dynamic endpoint) Search the source code of any specified repository for relevant snippets.

07

search_generic_documentation

(Dynamic endpoint) Search the documentation of any specified repository for information matching a query.

Installation

Prerequisites:
1. Node.js ≥ 18 (LTS) and npm or pnpm
2. A personal GitHub access token with repo-read permissions (if you intend to serve private repositories)
Quick install (recommended – global CLI):
# install from npm if the package is published npm install -g git-mcp # or: pnpm add -g git-mcp # start the server on port 8080 git-mcp start --port 8080 --github-token $GITHUB_TOKEN
From source:
# clone the repo git clone https://github.com/idosal/git-mcp.git cd git-mcp # install dependencies npm install # or: pnpm install # build TypeScript npm run build # run the server (defaults to port 3000) GITHUB_TOKEN=<token> npm start
Docker (if a Dockerfile exists):
docker build -t gitmcp . docker run -d -p 3000:3000 -e GITHUB_TOKEN=<token> gitmcp
Configuration flags (CLI or env):
--port / MCP_PORT - HTTP port to expose (default: 3000)
--github-token / GITHUB_TOKEN - Personal access token for GitHub API calls
--log-level / LOG_LEVEL - debug | info | warn | error
Verify:
Visit http://localhost:3000/health or curl the endpoint to make sure the server is up.

Documentation

License: Apache License 2.0
Updated 7/30/2025

Table of Contents

git-mcp - MCP Server Registry - Augment Code