GitHub MCP Tools

Provides MCP endpoints to interact with GitHub: fetch user profiles, manage repositories, and handle pull requests.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "pranesh-2005-usingmcp": {
      "command": "mcp",
      "args": [
        "dev",
        "github_server.py"
      ],
      "env": {
        "GITHUB_PAT": "YOUR_GITHUB_PAT_TOKEN"
      }
    }
  }
}

You can automate GitHub workflows leveraging MCP by running a local MCP server that exposes commands to fetch user profiles, create repositories, manage pull requests, and more. This setup lets you integrate GitHub actions with AI agents or automation scripts in a secure, repeatable way.

How to use

To start using GitHub MCP tools with an MCP client, run the MCP server locally and point your client at it. The server reads your GitHub Personal Access Token from a .env file and provides endpoints for common GitHub actions through the MCP protocol.

How to install

Prerequisites you need before starting:

Python 3.8 or newer
MCP tooling installed so you can run the MCP command (mcp)

Steps to set up and run the server locally:

# 1) Clone the project
git clone https://github.com/Pranesh-2005/UsingMcp.git
cd UsingMcp

# 2) Create a GitHub Personal Access Token (PAT)
# Go to GitHub -> Settings -> Developer Settings -> Personal Access Tokens -> Tokens (classic) -> Generate New Token (classic)
# Save the token securely

# 3) Create a .env file and store your PAT
# Example content:
# GITHUB_PAT=ghp_*********************

# 4) Start the MCP server
mcp dev github_server.py

Additional sections

Security and authentication: store your GitHub PAT in a dedicated .env file and do not commit it to version control. Use the PAT scope that matches your automation needs and rotate it periodically.

Usage notes: you can perform actions such as listing repositories, creating new ones, merging pull requests, or deleting repositories only if the configured PAT has the necessary permissions on GitHub.

Troubleshooting: if the server fails to start, verify that Python 3.8+ is installed, the .env file exists with GITHUB_PAT correctly set, and that you are running the command from the project root where github_server.py resides.

Available tools

fetch_user_profile

Fetches detailed GitHub user profiles by username, returning public profile fields and related metadata.

create_repo

Creates a new GitHub repository under your account with specified name and options.

delete_repo

Deletes a repository you own or have permissions to remove, subject to GitHub policies.

create_and_merge_pr

Creates a pull request and merges it after review or automated checks pass.

list_repos

Lists repositories for an authenticated user or a specified username.

hello_world

A simple Hello World test tool to verify MCP connectivity.