GitHub Repository MCP Server

Integrations

  • Allows access to GitHub repository contents as context for AI models, providing tools to fetch entire repositories, specific file contents, and repository structure with capabilities for filtering by extension and excluding specific paths.

GitHub Repository MCP Server

This Model Context Protocol (MCP) server allows AI models to access GitHub repository contents as context. It provides tools to fetch file contents, repository structure, and entire repositories for use as context in AI interactions.

Features

  • Fetch entire repository contents as context
  • Get specific file contents from a repository
  • Get repository structure (file listing)
  • Filter files by extension
  • Exclude specific paths
  • Limit the number of files returned

Installation

# clone the repository git clone https://github.com/shanksxz/github-mcp.git cd github-mcp # install dependencies npm install # build the project npm run build

Usage

Setting up GitHub Authentication

While the server can work with public repositories without authentication, GitHub API has strict rate limits for unauthenticated requests (60 requests/hour). To increase this limit to 5000 requests/hour, set the GITHUB_TOKEN environment variable:

# create a file called gh.sh and add the following line: export GITHUB_TOKEN=your_github_personal_access_token # make the file executable chmod +x gh.sh # run the file ./gh.sh

You can create a personal access token in your GitHub Developer Settings.

Using with Cursor

To use this server with Cursor follow these steps:

  1. Open Cursor Settings
  2. Search for "MCP"
  3. Click on "Add a new MCP Server"
  4. Enter the following information:
    • Name: github-repo-context (or any name you want)
    • Type: Command
    • Command: /path/to/your-local-repo-setup/gh.sh
  5. Click "Save"
  6. Enable the server by clicking the toggle next to the server name
  7. You should now be able to use the server in your project

The server communicates via stdin/stdout following the MCP protocol.

Available Tools

The server provides the following tools:

  1. get-repo-context: Get all files from a GitHub repository to use as context
    • Parameters:
      • owner: GitHub repository owner/organization name
      • repo: GitHub repository name
      • maxFiles (optional): Maximum number of files to include (default: 50)
      • fileExtensions (optional): File extensions to include (e.g., ['js', 'ts', 'md'])
      • excludePaths (optional): Paths to exclude (default: ['node_modules', 'dist', 'build'])
  2. get-file-content: Get content of a specific file from a GitHub repository
    • Parameters:
      • owner: GitHub repository owner/organization name
      • repo: GitHub repository name
      • path: Path to the file in the repository
  3. get-repo-structure: Get the structure of a GitHub repository
    • Parameters:
      • owner: GitHub repository owner/organization name
      • repo: GitHub repository name

Example

When integrated with an AI model that supports MCP, you can use commands like:

Get the structure of the repository tensorflow/tensorflow

The AI would then use the get-repo-structure tool to fetch and display the repository structure.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI models to access GitHub repository contents as context, with features to fetch entire repositories, specific file contents, and repository structures for use in AI interactions.

  1. Features
    1. Installation
      1. Usage
        1. Setting up GitHub Authentication
        2. Using with Cursor
        3. Available Tools
      2. Example

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          A server that allows AI assistants to browse and read files from specified GitHub repositories, providing access to repository contents via the Model Context Protocol.
          Last updated -
          3
          JavaScript
          MIT License
          • Apple
        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables AI agents to retrieve and understand entire codebases at once, providing tools to analyze local workspaces or remote GitHub repositories.
          Last updated -
          9
          TypeScript
          MIT License
          • Linux
          • Apple
        • A
          security
          F
          license
          A
          quality
          A Model Context Protocol server that enables AI models to interact with GitHub's API, allowing for repository creation and management with descriptions, topics, and website URLs through natural language commands.
          Last updated -
          1
          JavaScript
        • -
          security
          F
          license
          -
          quality
          Provides integration with Github through the Model Context Protocol (MCP), allowing Large Language Models to interact with Github's repositories, issues, pull requests and search functionality.
          Last updated -
          1
          TypeScript
          • Apple

        View all related MCP servers

        ID: ncc1bjxpdm