git-mcp  by idosal

MCP server for connecting AI tools to GitHub repos

Created 9 months ago
7,348 stars

Top 6.9% 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

4 months ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
0
Star History
229 stars in the last 30 days

Explore Similar Projects

Starred by Andrej Karpathy Andrej Karpathy(Founder of Eureka Labs; Formerly at Tesla, OpenAI; Author of CS 231n), Tobi Lutke Tobi Lutke(Cofounder of Shopify), and
33 more.

opencode by anomalyco

26.5%
60k
CLI tool for AI-assisted coding in the terminal
Created 8 months ago
Updated 10 hours ago
Feedback? Help us improve.