MCP.so
Sign In

GitHub MCP Server

@kousen

Repository

About GitHub MCP Server

MCP wrapper for the `gh` command

#github#mcp#ai-assistant

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

12

List issues in a repository

Get details of a specific issue

Create a new issue

List pull requests

Get pull request details

Create a new pull request

Get file contents from repository

List user's repositories

Search GitHub repositories

Get authenticated user details

List repository branches

Create a new branch

Overview

What is GitHub MCP Server?

GitHub MCP Server is a Spring Boot‑based implementation of the Model Context Protocol that exposes GitHub operations as tools for AI assistants. It uses the GitHub CLI (gh) and Spring AI to let AI agents interact with repositories, issues, pull requests, and user account data.

How to use GitHub MCP Server?

First, install the GitHub CLI and authenticate with gh auth login. Then clone the repository, run ./gradlew build to compile, and start the server with ./gradlew bootRun. Configuration can be adjusted in src/main/resources/application.properties.

Key features of GitHub MCP Server

  • List and search GitHub repositories
  • List branches and create new branches
  • Get file contents from a repository
  • List, get, and create issues
  • List, get, and create pull requests
  • Retrieve authenticated user details

Use cases of GitHub MCP Server

  • An AI assistant managing repository branches and files for a user
  • Automating issue triage by listing and creating issues
  • Streamlining pull request creation and review workflows
  • Searching public repositories for code examples or dependencies
  • Fetching the authenticated user’s profile and repository list

FAQ from GitHub MCP Server

What are the prerequisites to run this server?

Java 21 or higher and the GitHub CLI (gh) installed and authenticated.

How do I authenticate with GitHub?

Run gh auth login in your terminal to authenticate the GitHub CLI.

What tools does the server expose?

It provides over a dozen tools including listIssues, createPullRequest, getFileContents, searchRepositories, createBranch, and more – all listed in the README’s tool table.

How do I build and run the server?

Clone the project, use ./gradlew build, then start with ./gradlew bootRun.

What technology stack does this server use?

Spring Boot 3.5.0, Spring AI 1.0.0, Java 21, GitHub CLI, and Gradle as the build tool.

Frequently asked questions

What are the prerequisites to run this server?

Java 21 or higher and the GitHub CLI (`gh`) installed and authenticated.

How do I authenticate with GitHub?

Run `gh auth login` in your terminal to authenticate the GitHub CLI.

What tools does the server expose?

It provides over a dozen tools including `listIssues`, `createPullRequest`, `getFileContents`, `searchRepositories`, `createBranch`, and more – all listed in the README’s tool table.

How do I build and run the server?

Clone the project, use `./gradlew build`, then start with `./gradlew bootRun`.

What technology stack does this server use?

Spring Boot 3.5.0, Spring AI 1.0.0, Java 21, GitHub CLI, and Gradle as the build tool.

Comments

Basic information

Category

Version Control

License

MIT license

Transports

stdio

Author

kousen

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

AIO-MCP Server

athapong

🚀 All-in-one MCP server with AI search, RAG, and multi-service integrations (GitLab/Jira/Confluence/YouTube) for AI-enhanced development workflows. Folk from https://github.com/nguyenvanduocit/all-in-one-model-context-protocol

36

Gitlab Mcp Server

jmrplens

Open source GitLab MCP server for AI assistants: 2-tool dynamic find/execute over 860+ GitLab actions (1,000+ Enterprise), stdio/HTTP/OAuth, safe/read-only modes.

31

Code Review Server

crazyrabbitLTC

A MCP server for code reviews

34

MCP Linear

tacticlaunch

MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.

141