GitHub Repo MCP
About
Browse GitHub repositories, explore directories, and view file contents.
Details
- License
- MIT
Explore
- 💻 Compatible with Cursor, Windsurf, Claude Desktop, and other MCP clients supporting stdio protocol
- 🔎 Browse the contents of any public GitHub repository
- 📂 Navigate through repository directories and subdirectories
- 📝 View the content of code and text files
- 📦 Easy installation via package manager
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
GitHub Repo MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Installing the server requires the following on your system:
- Node.js 18+
- npm or yarn
You can install and run GitHub Repo MCP using Smithery, NPX, or setting in mcp.json of your IDE:
To install GitHub Repo MCP for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @Ryan0204/github-repo-mcp --client claude
Wait a few seconds or click on the refresh button a few times if it does not register. If it still won't register, make sure you entered the right command.
The GitHub Repo MCP server can use a GitHub token for higher rate limits when accessing the GitHub API.
| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| GITHUB_TOKEN | No | None | Your GitHub personal access token for higher rate limits |
Here are some examples of how to use these tools with an AI assistant:
1. Browsing a repository root:
Ask your AI assistant to "Show me the contents of the repository at https://github.com/Ryan0204/github-repo-mcp"
2. Exploring a specific directory:
Ask "What files are in the src directory of https://github.com/Ryan0204/github-repo-mcp?"
3. Viewing a file:
Ask "Show me the README.md file from https://github.com/Ryan0204/github-repo-mcp"
The server provides three main tools for interacting with GitHub repositories:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"github repo mcp": {
"github-repo-mcp": {
"command": "npx",
"args": [
"github-repo-mcp"
]
}
}
}
}McpServers
{
"github-repo-mcp": {
"command": "npx",
"args": [
"github-repo-mcp"
]
}
}<p class="center-text">
<strong>GitHub Repo MCP is an open-source MCP server that lets your AI assistants browse GitHub repositories, explore directories, and view file contents.</strong>
</p>
<a href="https://glama.ai/mcp/servers/@Ryan0204/github-repo-mcp">
</a>
Table of contents
<p class="center-text">
<a href="#getting-started">Getting started</a> •
<a href="#feature-overview">Feature overview</a>
</p>
✨ Key features
- 💻 Compatible with Cursor, Windsurf, Claude Desktop, and other MCP clients supporting stdio protocol
- 🔎 Browse the contents of any public GitHub repository
- 📂 Navigate through repository directories and subdirectories
- 📝 View the content of code and text files
- 📦 Easy installation via package manager
Getting Started
Prerequisites
Installing the server requires the following on your system:
- Node.js 18+
- npm or yarn
Step 1. Installation
You can install and run GitHub Repo MCP using Smithery, NPX, or setting in mcp.json of your IDE:
MacOS
npx github-repo-mcp
Windows NPX
cmd /c npx -y github-repo-mcp
Windows NPX via .cursor/mcp.json
{
"mcpServers": {
"github-repo-mcp": {
"command": "wsl",
"args": [
"bash",
"-c",
"cmd /c npx -y github-repo-mcp"
],
"enabled": true
}
}
}
Windows NPX via .cursor/mcp.json (if path not set)
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
