GitHub MCP Server

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.