이 프로젝트는 GitHub API 액세스를 위한 Model Context Protocol (MCP) 서버를 구현합니다. LLM 에이전트가 GitHub 저장소, 문제, 풀 요청 및 기타 GitHub 리소스와 상호 작용할 수있는 도구 세트를 제공합니다.

특징

서버는 다음과 같은 GitHub 작업을 제공합니다:

• 리포지토리 관리

• 인증된 사용자를 위한 목록 저장소

• repository 세부사항을 얻으십시오

• 저장소 검색

• Issue 관리

• 옵션 필터링에 대한 문제 목록

• 문제점에 대한 자세한 정보 얻기

• 새 문제 만들기

• 문제에 대한 의견 추가

• 문제 검색

• Pull 요청 관리

• 필터링 옵션이있는 목록 풀 요청

• Pull Request에 대한 자세한 정보 얻기

• Pull Request에 대한 의견 만들기

• Merge Pull 요청

• ** 브랜치 관리 **

• 저장소의 목록 지점

• 새 지점 만들기

• 관리

• 커밋에 대한 자세한 정보를 얻기

• 목록은 필터링 옵션으로 커밋

• 메시지로 커밋 검색

• ** 콘텐츠 관리**

• 저장소에서 파일 내용을 가져옵니다.

• 디렉토리 내용

• 파일 생성 또는 업데이트

• 저장소 내의 코드 검색

GitHub MCP Server

This project implements a Model Context Protocol (MCP) server for GitHub API access. It provides a set of tools that allow LLM agents to interact with GitHub repositories, issues, pull requests, and other GitHub resources.

Features

The server provides the following GitHub operations:

• Repository Management

  • List repositories for the authenticated user
  • Get repository details
  • Search for repositories

• Issue Management

  • List issues with filtering options
  • Get detailed information about issues
  • Create new issues
  • Add comments to issues
  • Search for issues

• Pull Request Management

  • List pull requests with filtering options
  • Get detailed information about pull requests
  • Create comments on pull requests
  • Merge pull requests

• Branch Management

  • List branches in a repository
  • Create new branches

• Commit Management

  • Get detailed information about commits
  • List commits with filtering options
  • Search for commits by message

• Content Management

  • Get file contents from repositories
  • List directory contents
  • Create or update files
  • Search for code within repositories

These operations are exposed as tools for Large Language Models using the Model Context Protocol (MCP), allowing AI systems to safely interact with GitHub through its API.

Claude Desktop

DevoxxGenie IDEA plugin

Getting Started

Prerequisites

• Java 17 or higher
• Maven 3.6+
• Spring Boot 3.3.6
• Spring AI MCP Server components
• A GitHub account and personal access token

Building the Project

Build the project using Maven:

mvn clean package

Running the Server

Run the server using the following command:

java -jar target/GitHubMCP-1.0-SNAPSHOT.jar

The server can use STDIO for communication with MCP clients or can be run as a web server.

Environment Variables

The GitHub MCP server supports the following environment variables for authentication:

• GITHUB_TOKEN or GITHUB_PERSONAL_ACCESS_TOKEN: Your GitHub personal access token
• GITHUB_HOST: The base URL of your GitHub instance (e.g., github.com or github.mycompany.com for GitHub Enterprise)
• GITHUB_REPOSITORY: Default repository to use if not specified in API calls (e.g., owner/repo)

You can set these environment variables when launching the MCP server, and the GitHub services will use them as default values. This allows you to avoid having to provide authentication details with every API call.

Usage with MCP Clients

Using with Claude Desktop

Edit your claude_desktop_config.json file with the following:

{
  "mcpServers": {
    "github": {
      "command": "java",