Skip to main content
Glama
Shru4241

github-mcp-server

by Shru4241
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Remote

GitHub MCP Server

A Python-based Model Context Protocol (MCP) server that allows AI assistants and MCP clients to interact with GitHub through tools.

The server uses the GitHub REST API and provides tools for repository management, issue management, file operations, branches, and pull requests.

🏗️ Architecture

                         User
                          |
                          v
                 AI Assistant / MCP Client
                          |
                          v
                  GitHub MCP Server
                     (FastMCP)
                          |
                          v
                   MCP Tool Selection
                          |
             +------------+------------+
             |            |            |
             v            v            v
       Repository       Issues       Files
          Tools          Tools        Tools
             |            |            |
             +------------+------------+
                          |
             +------------+------------+
             |                         |
             v                         v
        Branches                 Pull Requests
          Tools                      Tools
             |                         |
             +------------+------------+
                          |
                          v
                  GitHub REST API
                          |
                          v
                  GitHub Repositories
                          |
                          v
                  API Response / Data
                          |
                          v
                 GitHub MCP Server
                          |
                          v
                   Final Response
                          |
                          v
                         User

Related MCP server: github-mcp

Features

  • Get GitHub repository information

  • List a user's repositories

  • Get open issues from a repository

  • Create GitHub issues

  • Create GitHub repositories

  • Search GitHub repositories

  • Add comments to issues

  • Close GitHub issues

  • List repository files and folders

  • Read repository file contents

  • Create or update repository files

  • Create GitHub branches

  • Create pull requests

  • Merge pull requests

  • Delete repository files

Technologies Used

  • Python

  • Model Context Protocol (MCP)

  • FastMCP

  • GitHub REST API

  • Requests

  • python-dotenv

  • MCP Inspector

Installation

1. Clone the repository

git clone https://github.com/Shru4241/github-mcp-server.git

2. Create a Virtual Environment

python -m venv venv

3. Activate the Virtual Environment

Windows PowerShell:

venv\Scripts\Activate.ps1

Windows Command Prompt:

venv\Scripts\activate

4. Install Dependencies

pip install -r requirements.txt

Environment Variables

Create a .env file in the project root:

GITHUB_TOKEN=your_github_personal_access_token

Replace your_github_personal_access_token with your own GitHub Personal Access Token.

Never share your GitHub token or commit the .env file to GitHub.

Running the Server

Activate the virtual environment and run:

python server.py

The MCP server uses STDIO communication and waits for an MCP client to connect.

MCP Inspector

You can test the server using MCP Inspector.

Use:

npx @modelcontextprotocol/inspector@latest

Then configure the server with:

Command:

C:\path\to\github-mcp-server\venv\Scripts\python.exe

Arguments:

C:\path\to\github-mcp-server\server.py

Working Directory:

C:\path\to\github-mcp-server

Available Tools

Tool

Description

get_repo_info

Get repository information

list_repositories

List repositories for a user

get_repo_issues

Get open issues

create_issue

Create a new issue

create_repository

Create a GitHub repository

search_repositories

Search GitHub repositories

add_issue_comment

Add a comment to an issue

close_issue

Close an issue

get_repo_files

List repository files and folders

read_repo_file

Read a repository file

create_or_update_file

Create or update a repository file

create_branch

Create a new branch

create_pull_request

Create a pull request

merge_pull_request

Merge a pull request

delete_repo_file

Delete a repository file

Project Structure

github-mcp-server/
│
├── server.py
├── requirements.txt
├── README.md
├── .gitignore
└── .env

Note: .env contains your GitHub token and must not be uploaded to GitHub.

Example Workflow

The server can perform a complete GitHub development workflow:

Create Branch
      ↓
Create / Update File
      ↓
Commit Changes
      ↓
Create Pull Request
      ↓
Merge Pull Request

Author

Created as a Python-based GitHub MCP Server project.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • GitHub MCP Server

    nkefor
    F
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables LLMs to interact with GitHub repositories, issues, pull requests, and workflows through the Model Context Protocol. It provides a comprehensive set of tools for repository management, issue tracking, code search, and CI/CD automation.
    -

  • github-mcp

    Seey215
    A
    license
    C
    quality
    D
    maintenance
    Enables AI assistants to directly operate GitHub repositories, such as listing issues, through the Model Context Protocol.
    2
    30
    2
    Apache 2.0

  • github-mcp

    fleXRPL
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to interact with GitHub repositories, issues, pull requests, and content via the Model Context Protocol.
    1
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Shru4241/github-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server