ghcontext: Supercharge Your LLMs with Real-time GitHub Context

Name: ghcontext: Supercharge Your LLMs with Real-time GitHub Context
Author: MarcoMuellner

@MarcoMuellner

Repository

About ghcontext: Supercharge Your LLMs with Real-time GitHub Context

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

#ghcontext #github #llm-integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is ghcontext?

ghcontext is an MCP (Model Context Protocol) server that bridges GitHub and large language models, giving AI assistants real-time access to repository information – including private repos – via the standardized MCP protocol. It is designed for developers who want their LLMs to have accurate, up-to-date knowledge of codebases.

How to use ghcontext?

Install and run via npx ghcontext --GITHUB_TOKEN your_github_token or globally with npm install -g ghcontext then ghcontext --GITHUB_TOKEN your_github_token. After starting, connect your MCP‑compatible LLM to http://localhost:3000/api/mcp. The server exposes tools such as get-repository-info, get-repository-readme, and get-repository-api-docs.

Key features of ghcontext

API documentation extraction from READMEs and doc files
Repository structure analysis for a codebase map
README content retrieval directly from GitHub
File content search for specific files or snippets
Repository search to discover matching repositories
Intelligent caching to reduce API calls while keeping info fresh

Use cases of ghcontext

Providing LLMs with the latest API docs and READMEs for any repository
Helping AI assistants understand private repository structure and design principles
Keeping AI assistants informed about recent changes and updates in a codebase
Assisting with code review by fetching current file contents and architecture

FAQ from ghcontext

Does ghcontext require authentication?

Yes. A GitHub token is mandatory; you are responsible for managing it securely and should grant only the scopes needed (e.g., public_repo for public repos only).

Can ghcontext access private repositories?

Yes, provided the GitHub token has the necessary scopes to read those private repos.

What tools does ghcontext expose?

It provides tools such as get-repository-info, get-repository-readme, get-repository-api-docs, search-repository-files, and get-file-content.