GitMCP
What is GitMCP?
Stop vibe-hallucinating and start vibe-coding!
GitMCP is a free, open-source, remote Model Context Protocol (MCP) server that transforms any GitHub project (repositories or GitHub pages) into a documentation hub. It allows AI tools like Cursor to access up-to-date documentation and code, ending code hallucinations seamlessly.
Features
- Latest Documentation on ANY GitHub Project: Grant your AI assistant seamless access to the GitHub project's documentation and code. The built-in smart search capabilities help find exactly what the AI needs without using too many tokens!
- No More Hallucinations: With GitMCP, your AI assistant can provide accurate and relevant answers to your questions.
- Zero Setup: GitMCP runs in the cloud. Simply add the chosen GitMCP URL as an MCP server in your IDE no downloads, installations, signups, or changes are required.
- Free and Private: GitMCP is open-source and completely free to use. It doesn't collect personal information or store queries. You can even self-host it!
<video src="https://github.com/user-attachments/assets/2c3afaf9-6c08-436e-9efd-db8710554430"></video>
Getting Started
Using GitMCP is easy! Simply follow these steps:
Step 1: Choose the type of server you want
Choose one of these URL formats depending on what you want to connect to:
- For GitHub repositories:
gitmcp.io/{owner}/{repo}
- For GitHub Pages sites:
{owner}.gitmcp.io/{repo}
- For a generic tool that supports any repository (dynamic):
gitmcp.io/docs
Replace
{owner} with the GitHub username or organization name, and {repo} with the repository name.For your convenience, you can also use the conversion tool on the landing page to format the GitHub URL into an MCP URL!
Step 2: Connect your AI assistant
Select your AI assistant from the options below and follow the configuration instructions:
Connecting Cursor
Update your Cursor configuration file at
~/.cursor/mcp.json:Connecting Claude Desktop
- In Claude Desktop, go to Settings > Developer > Edit Config
- Replace the configuration with:
Connecting Windsurf
Update your Windsurf configuration file at
~/.codeium/windsurf/mcp_config.json:Connecting VSCode
Update your VSCode configuration file at
.vscode/mcp.json:Connecting Cline
Update your Cline configuration file at
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:Connecting Highlight AI
- Open Highlight AI and click the plugins icon (@ symbol) in the sidebar
- Click Installed Plugins at the top of the sidebar
- Select Custom Plugin
- Click Add a plugin using a custom SSE URL
Plugin name:
gitmcp
SSE URL: https://gitmcp.io/{owner}/{repo}For more details on adding custom MCP servers to HighlightAI, refer to the documentation.
Note: Remember to replace{owner}and{repo}with the actual GitHub username/organization and repository name. You can also use the dynamic endpointhttps://gitmcp.io/docsto allow your AI to access any repository on demand.
How It Works
GitMCP connects your AI assistant to GitHub repositories using the Model Context Protocol (MCP), a standard that lets AI tools request additional information from external sources.
What happens when you use GitMCP:
- You provide the GitMCP URL to your AI assistant (e.g.,
gitmcp.io/microsoft/typescript). GitMCP exposes tools like documentation fetching, smart search, code search, etc.
- Prompt the AI assistant on documentation/code-related questions.
- Your AI sends requests to GitMCP to use its tools (with your approval).
- GitMCP executes the AI's request and returns the requested data.
- Your AI receives the information and generates a more accurate, grounded response without hallucinations.
Supported Documentation
GitMCP currently supports the following documents (in order of priority):
- AI-optimized version of the project's documentation
README.md/root
Examples
Here are some examples of how to use GitMCP with different AI assistants and repositories:
Example 1: Using Windsurf with a specific repository
For the GitHub repository
https://github.com/microsoft/playwright-mcp, add https://gitmcp.io/microsoft/playwright-mcp as an MCP server to Windsurf.Prompt to Claude:
"How do I use the Playwright MCP"
Windsurf will pull the relevant documentation from GitMCP to implement the memory feature correctly.
Example 2: Using Cursor with a GitHub Pages site
For the GitHub Pages site
langchain-ai.github.io/langgraph, add https://langchain-ai.gitmcp.io/langgraph as an MCP server to Cursor.Prompt to Cursor:
"Add memory to my LangGraph agent"
Cursor will pull the relevant documentation and code from GitMCP to correctly implement the memory feature.
Example 3: Using Claude Desktop with the dynamic endpoint
You don't have to pick specific repositories. The generic
gitmcp.io/docs endpoint allows AI to pick the GitHub project on the fly!Prompt to any AI assistant:
"I want to learn about the OpenAI Whisper speech recognition model. Explain how it works.
Claude will pull the data from GitMCP and answer the question.
Tools
GitMCP provides AI assistants with several valuable tools to help them access, understand, and query GitHub repositories.
`fetch_<repo-name>_documentation`
This tool gets the primary documentation from a GitHub repository. It works by retrieving relevant documentation (e.g.,
llms.txt). This gives the AI a good overview of what the project is aboutWhen it's useful: For general questions about a project's purpose, features, or how to get started
`search_<repo-name>_documentation`
This tool lets the AI search through a repository's documentation by providing a specific search query. Instead of loading all documentation (which could be very large), it uses smart search to find just the relevant parts.
When it's useful: For specific questions about particular features, functions, or concepts within a project
`fetch_url_content`
This tool helps the AI get information from links mentioned in the documentation. It retrieves the content from those links and converts it to a format the AI can easily read.
When it's useful: When documentation references external information that would help answer your question
`search_<repo-name>_code`
This tool searches through the actual code in the repository using GitHub's code search. It helps AI find specific code examples or implementation details.
When it's useful: When you want examples of how something is implemented or need technical details not covered in documentation
Note: When using the dynamic endpoint (gitmcp.io/docs), these tools are named slightly differently (fetch_generic_documentation,search_generic_code, andsearch_generic_documentation) and need additional information about which repository to access.
FAQ
What is the Model Context Protocol?
The Model Context Protocol is a standard that allows AI assistants to request and receive additional context from external sources in a structured manner, enhancing their understanding and performance.
Does GitMCP work with any AI assistant?
Yes, GitMCP is compatible with any AI assistant supporting the Model Context Protocol, including tools like Cursor, VSCode, Claude, etc.
Is GitMCP compatible with all GitHub projects?
Absolutely! GitMCP works with any public GitHub repository without requiring any modifications. It prioritizes the
llms.txt file and falls back to README.md or other pages if the former is unavailable. Future updates aim to support additional documentation methods and even generate content dynamically.Does GitMCP cost money?
No, GitMCP is a free service to the community with no associated costs.
Privacy
GitMCP is deeply committed to its users' privacy. The service doesn't have access to or store any personally identifiable information as it doesn't require authentication. In addition, it doesn't store any queries sent by the agents. Moreover, as GitMCP is an open-source project, it can be deployed independently in your environment.
GitMCP only accesses content that is already publicly available and only when queried by a user. GitMCP does not automatically scrape repositories. Before accessing any GitHub Pages site, the code checks for
robots.txt rules and follows the directives set by site owners, allowing them to opt out. Please note that GitMCP doesn't permanently store data regarding the GitHub projects or their content.Contributing
We welcome contributions, feedback, and ideas! Please review our contribution guidelines.
Local Development Setup
- Clone the repository
- Install dependencies
- Run locally for development
Using MCP Inspector for Testing
- Install the MCP Inspector tool:
- In the inspector interface:
License
This project is licensed under the Apache License 2.0.
Disclaimer
GitMCP is provided "as is" without warranty of any kind. While we strive to ensure the reliability and security of our service, we are not responsible for any damages or issues that may arise from its use. GitHub projects accessed through GitMCP are subject to their respective owners' terms and conditions. GitMCP is not affiliated with GitHub or any of the mentioned AI tools.
Star History
GitMCP
What is GitMCP?
Stop vibe-hallucinating and start vibe-coding!
GitMCP is a free, open-source, remote Model Context Protocol (MCP) server that transforms any GitHub project (repositories or GitHub pages) into a documentation hub. It allows AI tools like Cursor to access up-to-date documentation and code, ending code hallucinations seamlessly.
Features
- Latest Documentation on ANY GitHub Project: Grant your AI assistant seamless access to the GitHub project's documentation and code. The built-in smart search capabilities help find exactly what the AI needs without using too many tokens!
- No More Hallucinations: With GitMCP, your AI assistant can provide accurate and relevant answers to your questions.
- Zero Setup: GitMCP runs in the cloud. Simply add the chosen GitMCP URL as an MCP server in your IDE no downloads, installations, signups, or changes are required.
- Free and Private: GitMCP is open-source and completely free to use. It doesn't collect personal information or store queries. You can even self-host it!
<video src="https://github.com/user-attachments/assets/2c3afaf9-6c08-436e-9efd-db8710554430"></video>
Getting Started
Using GitMCP is easy! Simply follow these steps:
Step 1: Choose the type of server you want
Choose one of these URL formats depending on what you want to connect to:
- For GitHub repositories:
gitmcp.io/{owner}/{repo}
- For GitHub Pages sites:
{owner}.gitmcp.io/{repo}
- For a generic tool that supports any repository (dynamic):
gitmcp.io/docs
Replace
{owner} with the GitHub username or organization name, and {repo} with the repository name.For your convenience, you can also use the conversion tool on the landing page to format the GitHub URL into an MCP URL!
Step 2: Connect your AI assistant
Select your AI assistant from the options below and follow the configuration instructions:
Connecting Cursor
Update your Cursor configuration file at
~/.cursor/mcp.json:Connecting Claude Desktop
- In Claude Desktop, go to Settings > Developer > Edit Config
- Replace the configuration with:
Connecting Windsurf
Update your Windsurf configuration file at
~/.codeium/windsurf/mcp_config.json:Connecting VSCode
Update your VSCode configuration file at
.vscode/mcp.json:Connecting Cline
Update your Cline configuration file at
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:Connecting Highlight AI
- Open Highlight AI and click the plugins icon (@ symbol) in the sidebar
- Click Installed Plugins at the top of the sidebar
- Select Custom Plugin
- Click Add a plugin using a custom SSE URL
Plugin name:
gitmcp
SSE URL: https://gitmcp.io/{owner}/{repo}For more details on adding custom MCP servers to HighlightAI, refer to the documentation.
Note: Remember to replace{owner}and{repo}with the actual GitHub username/organization and repository name. You can also use the dynamic endpointhttps://gitmcp.io/docsto allow your AI to access any repository on demand.
How It Works
GitMCP connects your AI assistant to GitHub repositories using the Model Context Protocol (MCP), a standard that lets AI tools request additional information from external sources.
What happens when you use GitMCP:
- You provide the GitMCP URL to your AI assistant (e.g.,
gitmcp.io/microsoft/typescript). GitMCP exposes tools like documentation fetching, smart search, code search, etc.
- Prompt the AI assistant on documentation/code-related questions.
- Your AI sends requests to GitMCP to use its tools (with your approval).
- GitMCP executes the AI's request and returns the requested data.
- Your AI receives the information and generates a more accurate, grounded response without hallucinations.
Supported Documentation
GitMCP currently supports the following documents (in order of priority):
- AI-optimized version of the project's documentation
README.md/root
Examples
Here are some examples of how to use GitMCP with different AI assistants and repositories:
Example 1: Using Windsurf with a specific repository
For the GitHub repository
https://github.com/microsoft/playwright-mcp, add https://gitmcp.io/microsoft/playwright-mcp as an MCP server to Windsurf.Prompt to Claude:
"How do I use the Playwright MCP"
Windsurf will pull the relevant documentation from GitMCP to implement the memory feature correctly.
Example 2: Using Cursor with a GitHub Pages site
For the GitHub Pages site
langchain-ai.github.io/langgraph, add https://langchain-ai.gitmcp.io/langgraph as an MCP server to Cursor.Prompt to Cursor:
"Add memory to my LangGraph agent"
Cursor will pull the relevant documentation and code from GitMCP to correctly implement the memory feature.
Example 3: Using Claude Desktop with the dynamic endpoint
You don't have to pick specific repositories. The generic
gitmcp.io/docs endpoint allows AI to pick the GitHub project on the fly!Prompt to any AI assistant:
"I want to learn about the OpenAI Whisper speech recognition model. Explain how it works.
Claude will pull the data from GitMCP and answer the question.
Tools
GitMCP provides AI assistants with several valuable tools to help them access, understand, and query GitHub repositories.
`fetch_<repo-name>_documentation`
This tool gets the primary documentation from a GitHub repository. It works by retrieving relevant documentation (e.g.,
llms.txt). This gives the AI a good overview of what the project is aboutWhen it's useful: For general questions about a project's purpose, features, or how to get started
`search_<repo-name>_documentation`
This tool lets the AI search through a repository's documentation by providing a specific search query. Instead of loading all documentation (which could be very large), it uses smart search to find just the relevant parts.
When it's useful: For specific questions about particular features, functions, or concepts within a project
`fetch_url_content`
This tool helps the AI get information from links mentioned in the documentation. It retrieves the content from those links and converts it to a format the AI can easily read.
When it's useful: When documentation references external information that would help answer your question
`search_<repo-name>_code`
This tool searches through the actual code in the repository using GitHub's code search. It helps AI find specific code examples or implementation details.
When it's useful: When you want examples of how something is implemented or need technical details not covered in documentation
Note: When using the dynamic endpoint (gitmcp.io/docs), these tools are named slightly differently (fetch_generic_documentation,search_generic_code, andsearch_generic_documentation) and need additional information about which repository to access.
FAQ
What is the Model Context Protocol?
The Model Context Protocol is a standard that allows AI assistants to request and receive additional context from external sources in a structured manner, enhancing their understanding and performance.
Does GitMCP work with any AI assistant?
Yes, GitMCP is compatible with any AI assistant supporting the Model Context Protocol, including tools like Cursor, VSCode, Claude, etc.
Is GitMCP compatible with all GitHub projects?
Absolutely! GitMCP works with any public GitHub repository without requiring any modifications. It prioritizes the
llms.txt file and falls back to README.md or other pages if the former is unavailable. Future updates aim to support additional documentation methods and even generate content dynamically.Does GitMCP cost money?
No, GitMCP is a free service to the community with no associated costs.
Privacy
GitMCP is deeply committed to its users' privacy. The service doesn't have access to or store any personally identifiable information as it doesn't require authentication. In addition, it doesn't store any queries sent by the agents. Moreover, as GitMCP is an open-source project, it can be deployed independently in your environment.
GitMCP only accesses content that is already publicly available and only when queried by a user. GitMCP does not automatically scrape repositories. Before accessing any GitHub Pages site, the code checks for
robots.txt rules and follows the directives set by site owners, allowing them to opt out. Please note that GitMCP doesn't permanently store data regarding the GitHub projects or their content.Contributing
We welcome contributions, feedback, and ideas! Please review our contribution guidelines.
Local Development Setup
- Clone the repository
- Install dependencies
- Run locally for development
Using MCP Inspector for Testing
- Install the MCP Inspector tool:
- In the inspector interface:
License
This project is licensed under the Apache License 2.0.
Disclaimer
GitMCP is provided "as is" without warranty of any kind. While we strive to ensure the reliability and security of our service, we are not responsible for any damages or issues that may arise from its use. GitHub projects accessed through GitMCP are subject to their respective owners' terms and conditions. GitMCP is not affiliated with GitHub or any of the mentioned AI tools.