git-mcp  by idosal

MCP server for connecting AI tools to GitHub repos

created 4 months ago
3,694 stars

Top 13.4% on sourcepulse

GitHubView on GitHub
Project Summary

GitMCP provides a free, open-source Model Context Protocol (MCP) server that transforms any public GitHub repository into a documentation hub for AI assistants. It aims to eliminate AI code hallucinations by enabling tools like Cursor to access up-to-date documentation and code directly from the source, benefiting developers who need accurate, context-aware AI assistance.

How It Works

GitMCP acts as a remote MCP server, exposing tools for AI assistants to fetch and search documentation and code from GitHub repositories. When an AI assistant needs information, it sends requests to GitMCP, which retrieves relevant data (prioritizing llms.txt, then README.md) and returns it. This approach allows AI to access current project details, even for new or rapidly changing libraries, leading to more accurate and grounded responses.

Quick Start & Requirements

  • Install/Run: No installation required; use provided URLs.
  • Prerequisites: An AI assistant that supports the Model Context Protocol (e.g., Cursor, Claude Desktop, Windsurf, VSCode, Highlight AI).
  • Setup: Add a GitMCP URL to your AI assistant's configuration.
  • Links:

Highlighted Details

  • Supports specific repositories (gitmcp.io/{owner}/{repo}) or a generic server (gitmcp.io/docs) for dynamic access.
  • Offers tools for fetching documentation, searching documentation, fetching URL content, and searching code.
  • Includes an embedded chat for direct interaction with repository documentation.
  • Provides a badge to add to READMEs, showcasing documentation access counts.

Maintenance & Community

  • Project maintained by idosal.
  • Links to Twitter accounts for contributors: @idosal1, @liadyosef.
  • Contribution guidelines are available.

Licensing & Compatibility

  • Licensed under the Apache License 2.0.
  • Compatible with any public GitHub repository and AI assistants supporting the Model Context Protocol.
  • Can be self-hosted.

Limitations & Caveats

GitMCP relies on the AI correctly identifying the target repository when using the generic gitmcp.io/docs endpoint. While it prioritizes llms.txt and README.md, support for other documentation formats is planned for future updates. Access to GitHub Pages sites respects robots.txt rules.

Health Check
Last commit

1 day ago

Responsiveness

1 day

Pull Requests (30d)
3
Issues (30d)
7
Star History
1,780 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.