GitHub MCP Server

by renantrendt

Integrations

  • Enables repository management, file operations (create, update, read), issue tracking, pull request creation, branch management, search capabilities, and commit history viewing through the GitHub API.

GitHub MCP Server

A Model Context Protocol (MCP) server for interacting with GitHub. This tool allows AI assistants to perform various GitHub operations including repository management, file operations, issue tracking, and more.

Features

  • Repository Operations: Create repositories, fork repositories
  • File Operations: Create, update, and read files, push multiple files in a single commit
  • Issue Management: Create, update, list, and comment on issues
  • Pull Requests: Create pull requests
  • Branch Management: Create branches
  • Search Capabilities: Search code, repositories, issues, and users
  • Commit History: List commits

Setup

Prerequisites

  • Node.js 18 or higher
  • A GitHub Personal Access Token with appropriate permissions

Installation

  1. Clone this repository
  2. Install dependencies:
    npm install
  3. Build the project:
    npm run build

Configuration

This MCP server requires a GitHub Personal Access Token to authenticate with the GitHub API. The token should be provided as an environment variable:

GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here

When deploying with Smithery, the token is configured through the githubPersonalAccessToken configuration option.

Usage

Running Locally

To run the server locally:

GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here node dist/index.js

Deploying with Smithery

This repository includes the necessary configuration files for deploying with Smithery:

  • Dockerfile: Defines how to build the Docker image for the MCP server
  • smithery.yaml: Configures how Smithery should start the MCP server

Refer to the Smithery documentation for deployment instructions.

Development

Building

npm run build

Linting

npm run lint

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

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.

A Model Context Protocol server that enables AI assistants to perform GitHub operations including repository management, file operations, issue tracking, and pull request creation.

  1. Features
    1. Setup
      1. Prerequisites
      2. Installation
      3. Configuration
    2. Usage
      1. Running Locally
      2. Deploying with Smithery
    3. Development
      1. Building
      2. Linting
    4. License

      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
        A Model Context Protocol server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.
        Last updated -
        129
        Python

      View all related MCP servers

      ID: 8hcyyii1c0