ghcontext: Supercharge Your LLMs with Real-time GitHub Context

by MarcoMuellner

351 downloads Not rated yet

GitHub

Developer Tools

About

An MCP server providing real-time GitHub data to LLMs, enhancing their software development capabilities.

Explore

- API Documentation Extraction: Automatically identifies and extracts API documentation from READMEs and dedicated documentation files
- Repository Structure Analysis: Provides a map of your codebase's organization
- README Content Retrieval: Gets the latest documentation directly from GitHub
- File Content Search: Find and extract specific files or code snippets
- Repository Search: Discover repositories matching specific criteria

npm version minor

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 ghcontext: Supercharge Your LLMs with Real-time GitHub Context

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

From the repository

npx ghcontext --GITHUB_TOKEN your_github_token

bash

npm install -g ghcontext

pnpm install Connect your MCP-compatible LLM to the ghcontext server endpoint:

http://localhost:3000/api/mcp
``

Your LLM will now have access to tools like: -get-repository-info: Get detailed information about a repository -get-repository-readme: Retrieve the current README content -get-repository-api-docs: Extract API documentation -search-repository-files: Find files in a repository -get-file-content`: Retrieve specific file contents

`search-repositories`

Search for GitHub repositories by query

`get-repository-info`

Get detailed information about a specific GitHub repository

`get-repository-readme`

Get the README content of a GitHub repository

`search-repository-files`

Search for files in a GitHub repository

`get-file-content`

Get the content of a specific file from a GitHub repository

`get-repository-structure`

Get the directory structure of a GitHub repository

`get-repository-api-docs`

Extract API documentation from a GitHub repository README

`search-repository-code`

Search for code within a GitHub repository

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ghcontext: supercharge your llms with real-time github context": {
            "ghcontext": {
                "command": "npx",
                "args": [
                    "ghcontext",
                    "--GITHUB_TOKEN",
                    "your_github_token"
                ]
            }
        }
    }
}

McpServers

{
    "ghcontext": {
        "command": "npx",
        "args": [
            "ghcontext",
            "--GITHUB_TOKEN",
            "your_github_token"
        ]
    }
}

> "But my GitHub repo changed yesterday..." - Never worry about outdated information in your AI assistants again.

ghcontext (GitHub Context Provider) bridges the gap between GitHub and Large Language Models, giving AI assistants real-time access to repository information through the standardized Model Context Protocol (MCP).

<p align="center">
ghcontext Architecture
</p>

🔥 Why ghcontext?

- Accurate, Real-time Information: LLMs often have outdated knowledge about repositories. ghcontext provides the latest API docs, README contents, and codebase structure - Also for private repos
- Deeper Understanding: Help LLMs grasp your project's architecture, design principles, and API usage patterns.
- Seamless Integration: Compatible with any MCP-enabled models, including Claude, GPT, and others.
- Highly Efficient: Intelligent caching reduces API calls while keeping information fresh.

✨ Key Features

🚀 Quick Start

A note on tokens

ghcontext requires a GitHub token for authentication. You are responsible for managing your token securely, and you should give it only the scopes really necessary for your use case.
For example, if you only need to read public repositories, you can create a token with the public_repo scope. ghcontext does not need write access to your repositories.

Installation

Method 1: Run without Installation using npx

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

search-repositories

get-repository-info

get-repository-readme

search-repository-files

get-file-content

get-repository-structure

get-repository-api-docs

search-repository-code

Claude Desktop / Cursor

McpServers

🔥 Why ghcontext?

✨ Key Features

🚀 Quick Start

A note on tokens

Installation

Method 1: Run without Installation using npx

More like this

Sentry

Github

Git

GitLab

`search-repositories`

`get-repository-info`

`get-repository-readme`

`search-repository-files`

`get-file-content`

`get-repository-structure`

`get-repository-api-docs`

`search-repository-code`