MCP.so
Sign In

ghcontext: Supercharge Your LLMs with Real-time GitHub Context

@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

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

8

Search for GitHub repositories by query

Get detailed information about a specific GitHub repository

Get the README content of a GitHub repository

Search for files in a GitHub repository

Get the content of a specific file from a GitHub repository

Get the directory structure of a GitHub repository

Extract API documentation from a GitHub repository README

Search for code within a GitHub repository

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.

How does ghcontext integrate with LLMs?

It uses the standard MCP protocol, so any MCP‑enabled model (including Claude and GPT) can connect to its HTTP endpoint.

Does ghcontext cache GitHub API responses?

Yes, an intelligent caching system improves performance and reduces API load while keeping information fresh.

Frequently asked questions

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`.

How does ghcontext integrate with LLMs?

It uses the standard MCP protocol, so any MCP‑enabled model (including Claude and GPT) can connect to its HTTP endpoint.

Does ghcontext cache GitHub API responses?

Yes, an intelligent caching system improves performance and reduces API load while keeping information fresh.

Comments

Basic information

Category

Version Control

Transports

stdio

Author

MarcoMuellner

More Version Control MCP servers

Gerrit Review MCP Server

cayirtepeomer

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

37

GitHub MCP Server Extension for Zed

LoamStudios

A GitHub MCP Server extension for Zed

91

GitLab

modelcontextprotocol

Model Context Protocol Servers

88.1K

GitMCP

idosal

Put an end to code hallucinations! GitMCP is a free, open-source, remote MCP server for any GitHub project

8.2K

Atlassian Bitbucket MCP Server

aashari

Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.

157