[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73497":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":23,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":35,"readmeContent":36,"aiSummary":37,"trendingCount":16,"starSnapshotCount":16,"syncStatus":38,"lastSyncTime":39,"discoverSource":40},73497,"git-mcp","idosal\u002Fgit-mcp","idosal","Put an end to code hallucinations! GitMCP is a free, open-source, remote MCP server for any GitHub project","https:\u002F\u002Fgitmcp.io",null,"TypeScript",8157,722,46,52,0,13,38,89,39,39.58,"Apache License 2.0",false,"main",[26,27,28,29,30,31,32,33,34],"agentic-ai","agents","ai","claude","copilot","cursor","git","llm","mcp","2026-06-12 02:03:14","# GitMCP\n\n\u003Cp align=\"center\">\n  \u003Cimg width=\"884\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F2bf3e3df-556c-49c6-ab7b-36c279d53bba\" \u002F>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#-what-is-gitmcp\">What is GitMCP\u003C\u002Fa> •\n  \u003Ca href=\"#-features\">Features\u003C\u002Fa> •\n  \u003Ca href=\"#-getting-started\">Getting Started\u003C\u002Fa> •\n  \u003Ca href=\"#-how-it-works\">How It Works\u003C\u002Fa> •\n  \u003Ca href=\"#-badge\">Badge\u003C\u002Fa> •\n  \u003Ca href=\"#-examples\">Examples\u003C\u002Fa> •\n  \u003Ca href=\"#-faq\">FAQ\u003C\u002Fa> •\n  \u003Ca href=\"#-privacy\">Privacy\u003C\u002Fa> •\n  \u003Ca href=\"#-contributing\">Contributing\u003C\u002Fa> •\n  \u003Ca href=\"#-license\">License\u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cdiv align=\"center\">\n\n[![GitMCP](https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https:\u002F\u002Fgitmcp.io\u002Fbadge\u002Fidosal\u002Fgit-mcp)](https:\u002F\u002Fgitmcp.io\u002Fidosal\u002Fgit-mcp)\n[![Twitter Follow](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002Fidosal1?style=social)](https:\u002F\u002Ftwitter.com\u002Fidosal1)\n[![Twitter Follow](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002Fliadyosef?style=social)](https:\u002F\u002Ftwitter.com\u002Fliadyosef)\n\u003C\u002Fdiv>\n\n\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.pulsemcp.com\u002Fservers\u002Fidosal-git-mcp\">\u003Cimg src=\"https:\u002F\u002Fwww.pulsemcp.com\u002Fbadge\u002Ftop-pick\u002Fidosal-git-mcp\" width=\"400\" alt=\"Pulse MCP Badge\">\u003C\u002Fa>\n\u003C\u002Fdiv>\n\n## 🤔 What is GitMCP?\n**Stop vibe-hallucinating and start vibe-coding!**\n\n[GitMCP](https:\u002F\u002Fgitmcp.io) is a free, open-source, remote [Model Context Protocol (MCP)](https:\u002F\u002Fdocs.anthropic.com\u002Fen\u002Fdocs\u002Fagents-and-tools\u002Fmcp) server that transforms **any** GitHub project (repositories or GitHub pages) into a documentation hub. It enables AI tools like Cursor to access up-to-date documentation and code, even if the LLM has never encountered them, thereby eliminating code hallucinations seamlessly.\n\nGitMCP supports **two flavors** -\n\n*   **Specific Repository (`gitmcp.io\u002F{owner}\u002F{repo}` or `{owner}.gitmcp.io\u002F{repo}`):** Use these when you primarily work with a select number of libraries. This ensures your AI assistant always targets the correct project, enhancing security and relevance by preventing access to unintended repositories.\n*   **Generic Server (`gitmcp.io\u002Fdocs`):** Use this for maximum flexibility when you need to switch between different repositories frequently. The AI assistant will prompt you (or decide based on context) which repository to access for each request. Be mindful that this relies on correctly identifying the target repository each time.\n\n**With GitMCP:**\n\n*   AI assistants access the *latest* documentation and code directly from the source.\n*   Get accurate API usage and reliable code examples.\n*   Work effectively even with niche, new, or rapidly changing libraries.\n*   Significantly reduced hallucinations and improved code correctness.\n\nFor example, this side-by-side comparison shows the result for the same one-shot prompt in Cursor when creating a [three.js](https:\u002F\u002Fgithub.com\u002Fmrdoob\u002Fthree.js) scene -\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Ffbf1b4a7-f9f0-4c0e-831c-4d64faae2c45\n\n## ✨ Features\n\n- 😎 **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!\n- 🧠 **No More Hallucinations**: With GitMCP, your AI assistant can provide accurate and relevant answers to your questions.\n- ☁️ **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.\n- 💬 **Embedded Chat**: Start quickly by chatting directly with the repository's documentation through our in-browser chat!\n- ✅ **Open, 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!\n\n\u003Cvideo src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F2c3afaf9-6c08-436e-9efd-db8710554430\">\u003C\u002Fvideo>\n\n## 🚀 Getting Started\n\nUsing GitMCP is easy! Simply follow these steps:\n\n### Step 1: Choose the type of server you want\n\nChoose one of these URL formats depending on what you want to connect to:\n\n- For GitHub repositories: `gitmcp.io\u002F{owner}\u002F{repo}`\n- For GitHub Pages sites: `{owner}.gitmcp.io\u002F{repo}`\n- For a generic tool that supports any repository (dynamic): `gitmcp.io\u002Fdocs`\n\nReplace `{owner}` with the GitHub username or organization name, and `{repo}` with the repository name.\n\nFor your convenience, you can also use the conversion tool on the landing page to format the GitHub URL into an MCP URL!\n\n### Step 2: Connect your AI assistant\n\nSelect your AI assistant from the options below and follow the configuration instructions:\n\n#### Connecting Cursor\n\nUpdate your Cursor configuration file at `~\u002F.cursor\u002Fmcp.json`:\n   ```json\n   {\n     \"mcpServers\": {\n       \"gitmcp\": {\n         \"url\": \"https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\"\n       }\n     }\n   }\n   ```\n\n#### Connecting Claude Desktop\n\n1. In Claude Desktop, go to Settings > Developer > Edit Config\n2. Replace the configuration with:\n   ```json\n   {\n     \"mcpServers\": {\n       \"gitmcp\": {\n         \"command\": \"npx\",\n         \"args\": [\n           \"mcp-remote\",\n           \"https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\"\n         ]\n       }\n     }\n   }\n   ```\n\n#### Connecting Windsurf\n\nUpdate your Windsurf configuration file at `~\u002F.codeium\u002Fwindsurf\u002Fmcp_config.json`:\n   ```json\n   {\n     \"mcpServers\": {\n       \"gitmcp\": {\n         \"serverUrl\": \"https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\"\n       }\n     }\n   }\n   ```\n\n#### Connecting VSCode\n\nUpdate your VSCode configuration file at `.vscode\u002Fmcp.json`:\n   ```json\n   {\n     \"servers\": {\n       \"gitmcp\": {\n         \"type\": \"sse\",\n         \"url\": \"https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\"\n       }\n     }\n   }\n   ```\n\n#### Connecting Cline\n\nUpdate your Cline configuration file at `~\u002FLibrary\u002FApplication Support\u002FCode\u002FUser\u002FglobalStorage\u002Fsaoudrizwan.claude-dev\u002Fsettings\u002Fcline_mcp_settings.json`:\n   ```json\n   {\n     \"mcpServers\": {\n       \"gitmcp\": {\n         \"url\": \"https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\",\n         \"disabled\": false,\n         \"autoApprove\": []\n       }\n     }\n   }\n   ```\n\n#### Connecting Highlight AI\n\n1. Open Highlight AI and click the plugins icon (@ symbol) in the sidebar\n2. Click **Installed Plugins** at the top of the sidebar\n3. Select **Custom Plugin**\n4. Click **Add a plugin using a custom SSE URL**\n\nPlugin name: `gitmcp`\nSSE URL: `https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}`\n\nFor more details on adding custom MCP servers to HighlightAI, refer to [the documentation](https:\u002F\u002Fdocs.highlightai.com\u002Fplugins\u002Fcustom).\n\n#### Connecting Augment Code\n\n1. Open Augment Code settings\n2. Navigate to the MCP section\n3. Add a new MCP server with the following details:\n\nName the MCP server: `git-mcp Docs`\n\nUse this command:\n```bash\nnpx mcp-remote https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\n```\n\nOr use the following configuration:\n```json\n{\n  \"mcpServers\": {\n    \"git-mcp Docs\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\"\n      ]\n    }\n  }\n}\n```\n\n#### Connecting Msty AI\n1. Open Msty Studio\n2. Go to Tools > Import Tools from JSON Clipboard\n3. Paste the following configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"git-mcp Docs\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https:\u002F\u002Fgitmcp.io\u002F{owner}\u002F{repo}\"\n      ]\n    }\n  }\n}\n```\n\nFor more details on configuring MCP servers in Augment Code, visit [the Augment Code documentation](https:\u002F\u002Fdocs.augmentcode.com\u002Fsetup-augment\u002Fmcp).\n\n> **Note:** Remember to replace `{owner}` and `{repo}` with the actual GitHub username\u002Forganization and repository name. You can also use the dynamic endpoint `https:\u002F\u002Fgitmcp.io\u002Fdocs` to allow your AI to access any repository on demand.\n\n## ⚙ How It Works\n\nGitMCP 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.\n\nWhat happens when you use GitMCP:\n\n1. **You provide the GitMCP URL** to your AI assistant (e.g., `gitmcp.io\u002Fmicrosoft\u002Ftypescript`). GitMCP exposes tools like documentation fetching, smart search, code search, etc.\n2. **Prompt the AI assistant** on documentation\u002Fcode-related questions.\n3. **Your AI sends requests** to GitMCP to use its tools (with your approval).\n4. **GitMCP executes the AI's request** and returns the requested data.\n5. **Your AI receives the information** and generates a more accurate, grounded response without hallucinations.\n\n### Supported Documentation\n\nGitMCP currently supports the following documents (in order of priority):\n1. [llms.txt](https:\u002F\u002Fllmstxt.org)\n2. AI-optimized version of the project's documentation\n3. `README.md`\u002Froot\n\n## 💡 Examples\n\nHere are some examples of how to use GitMCP with different AI assistants and repositories:\n\n### Example 1: Using Windsurf with a specific repository\n\nFor the GitHub repository `https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fplaywright-mcp`, add `https:\u002F\u002Fgitmcp.io\u002Fmicrosoft\u002Fplaywright-mcp` as an MCP server to Windsurf.\n\n**Prompt to Claude:**\n> \"How do I use the Playwright MCP\"\n\nWindsurf will pull the relevant documentation from GitMCP to implement the memory feature correctly.\n\n### Example 2: Using Cursor with a GitHub Pages site\n\nFor the GitHub Pages site `langchain-ai.github.io\u002Flanggraph`, add `https:\u002F\u002Flangchain-ai.gitmcp.io\u002Flanggraph` as an MCP server to Cursor.\n\n**Prompt to Cursor:**\n> \"Add memory to my LangGraph agent\"\n\nCursor will pull the relevant documentation and code from GitMCP to correctly implement the memory feature.\n\n### Example 3: Using Claude Desktop with the dynamic endpoint\n\nYou don't have to pick specific repositories. The generic `gitmcp.io\u002Fdocs` endpoint allows AI to pick the GitHub project on the fly!\n\n**Prompt to any AI assistant:**\n> \"I want to learn about the OpenAI Whisper speech recognition model. Explain how it works.\"\n\nClaude will pull the data from GitMCP and answer the question.\n\n## 🛠️ Tools\n\nGitMCP provides AI assistants with several valuable tools to help them access, understand, and query GitHub repositories.\n\n### `fetch_\u003Crepo-name>_documentation`\n\nThis 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 about\n\n**When it's useful:** For general questions about a project's purpose, features, or how to get started\n\n### `search_\u003Crepo-name>_documentation`\n\nThis tool lets the AI search through a repository's documentation by providing a specific search query. Instead of loading all the documentation (which could be very large), it uses intelligent search to find just the relevant parts.\n\n**When it's useful:** For specific questions about particular features, functions, or concepts within a project\n\n### `fetch_url_content`\n\nThis 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.\n\n**When it's useful:** When documentation references external information that would help answer your question\n\n### `search_\u003Crepo-name>_code`\n\nThis tool searches through the actual code in the repository using GitHub's code search. It helps AI find specific code examples or implementation details.\n\n**When it's useful:** When you want examples of how something is implemented or need technical details not covered in documentation\n\n> **Note:** When using the dynamic endpoint (`gitmcp.io\u002Fdocs`), these tools are named slightly differently (`fetch_generic_documentation`, `search_generic_code`, and `search_generic_documentation`) and need additional information about which repository to access.\n\n## 📊 Badge\n\nGitMCP has a badge for your repository's README. It allows users to quickly access your documentation through their IDE or browser (using the embedded chat). It also showcases how many times your documentation has been accessed through GitMCP.\n\nExample (`idosal\u002Fgit-mcp`): [![GitMCP](https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https:\u002F\u002Fgitmcp.io\u002Fbadge\u002Fidosal\u002Fgit-mcp)](https:\u002F\u002Fgitmcp.io\u002Fidosal\u002Fgit-mcp)\n\n### Adding the Badge to Your Repository\n\nAdd the following to your `README.md`:\n\n```markdown\n[![GitMCP](https:\u002F\u002Fimg.shields.io\u002Fendpoint?url=https:\u002F\u002Fgitmcp.io\u002Fbadge\u002FOWNER\u002FREPO)](https:\u002F\u002Fgitmcp.io\u002FOWNER\u002FREPO)\n```\n\nReplace `OWNER` with your GitHub username or organization, and `REPO` with your repository name.\n\n### How We Count Views\n\nIncrement for each tool call on the specific repository.\n\n### Customizing the Badge\n\nYou can customize the badge's appearance with parameters:\n\n| Parameter | Description | Default | Example |\n|-----------|-------------|---------|---------|\n| `color` | Color for the badge value | `aquamarine` | `?color=green` |\n| `label` | Badge label | `GitMCP` | `Documentation`\n\nPlease reach out if you need help!\n\n## ❓ FAQ\n\n### What is the Model Context Protocol?\n\nThe [Model Context Protocol](https:\u002F\u002Fmodelcontextprotocol.io\u002Fintroduction) 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.\n\n### Does GitMCP work with any AI assistant?\n\nYes, GitMCP is compatible with any AI assistant supporting the Model Context Protocol, including tools like Cursor, VSCode, Claude, etc.\n\n### Is GitMCP compatible with all GitHub projects?\n\nAbsolutely! 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.\n\n### Does GitMCP cost money?\n\nNo, GitMCP is a free service to the community with no associated costs.\n\n## 🔒 Privacy\n\nGitMCP 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.\n\nGitMCP 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.\n\n## 👥 Contributing\n\nWe welcome contributions, feedback, and ideas! Please review our [contribution](https:\u002F\u002Fgithub.com\u002Fidosal\u002Fgit-mcp\u002Fblob\u002Fmain\u002F.github\u002FCONTRIBUTING.md) guidelines.\n\n### Local Development Setup\n\n1. **Clone the repository**\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002Fidosal\u002Fgit-mcp.git\n   cd git-mcp\n   ```\n\n2. **Install dependencies**\n   ```bash\n   pnpm install\n   ```\n\n3. **Run locally for development**\n   ```bash\n   npm run dev\n   # or\n   pnpm dev\n   ```\n\n#### Using MCP Inspector for Testing\n\n1. Install the MCP Inspector tool:\n   ```bash\n   npx @modelcontextprotocol\u002Finspector\n   ```\n\n2. In the inspector interface:\n   - Set Transport Type to `SSE`\n   - Enter your GitMCP URL (e.g., `http:\u002F\u002Flocalhost:5173\u002Fdocs`)\n   - Click \"Connect\"\n\n## 📄 License\n\nThis project is licensed under the [Apache License 2.0](LICENSE).\n\n## Disclaimer\n\nGitMCP 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.\n\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=idosal\u002Fgit-mcp&type=Timeline)](https:\u002F\u002Fwww.star-history.com\u002F#idosal\u002Fgit-mcp&Timeline)\n","GitMCP 是一个免费且开源的远程 Model Context Protocol (MCP) 服务器，旨在为任何 GitHub 项目提供最新的文档和代码访问。其核心功能包括通过特定仓库或通用服务器模式，让 AI 工具如 Cursor 能够获取到最准确的文档和代码示例，从而有效减少代码幻觉现象。技术上，GitMCP 使用 TypeScript 开发，并支持多种 AI 代理与工具集成。适用于开发者需要频繁切换不同项目或者使用较新、变化快的库时，确保 AI 辅助工具始终基于最新信息生成代码建议，提高开发效率与代码准确性。",2,"2026-06-11 03:45:50","high_star"]