MCP Github

This is a GitHub MCP Server project that supports interaction with LLM models such as Claude via the Model Context Protocol to implement the call and management functions of the GitHub API.

Developer tools Version control #GitHub Integration #MCP Protocol #AI Collaboration #Development Tools Local .TypeScript

rating : 2 points

downloads : 14

update time : 2025-04-28

What is the GitHub MCP Server?

This is a server that allows interaction with GitHub via the Model Context Protocol (MCP). It can perform various GitHub operations by sending structured requests and return corresponding responses.

How to use this server?

To use the server, you need to configure an appropriate client and communicate with it. The client can send requests containing the required operations and parameters, and the server will process and return the results.

Why choose the GitHub MCP Server?

This server provides developers with a unified way to interact with the GitHub API, simplifies the integration process, and supports a variety of advanced features.

GitHub ToolsProvides a set of tools for interacting with GitHub, including user authentication, repository operations, etc.

Octokit Client IntegrationBuilt - in support for the Octokit GitHub API client library, simplifying the API call process.

Custom ActionsAllows developers to extend the server's functionality and add more GitHub - related operations and tools.

Install the server

Configure environment variables

Start the server

Do I need programming skills to use this server?

Is my GitHub token secure?

Can I add more GitHub operations?

Model Context Protocol Documentation

Official resources for the MCP specification and official documentation.

Octokit GitHub Client Library

GitHub API client library integrated into the server for use.

🚀 GitHub MCP (Model Context Protocol) Server

This is an MCP (Model Context Protocol) server specifically designed for GitHub. It aims to support MCP-compatible large language models (LLMs), such as Claude, enabling them to communicate with my MCP server and interact via the GitHub API.

🚀 Quick Start

Requirements

TypeScript (Programming language)
Octokit (For sending API requests to GitHub)
Model Context Protocol SDK

Local Project Setup

Clone the repository.
Run npm install.
Create a .env file based on the provided .env.example file.
To compile TypeScript files to JavaScript, run npx tsc.
Finally, to run the project, run node build/index.js.

💻 Usage Examples

Testing Methods

You can test your MCP server in two ways:

Use the MCP Inspector.
Use Claude Desktop.

Testing with the MCP Inspector

Run npx @modelcontextprotocol/inspector node build/index.js in the terminal.
Open http://localhost:5173.
You can now use the MCP Inspector and start testing.

Testing with Claude Desktop

Download and install Claude Desktop from here.
Go to File > Settings... > Developer > Edit Configuration in the menu bar.
It will open the location of the claude_desktop_config.json file.
Open the file and add the following content in a code editor:

{
    "mcpServers": {
        "gh": {
            "command": "node",
            "args": ["Absolute\\Path\\To\\Your\\index.js\\File"],
            "env": {
                "GITHUB_TOKEN": "Your GitHub Personal Access Token"
            }
        }
    }
}

Exit and reopen Claude Desktop.

✨ Features

MCP mainly supports the following two types of features:

Tools (4)

create-issue: Create a new issue in a GitHub repository.
get-repo-info: Get information about a specific GitHub repository.
list-issues: List issues in a GitHub repository.
search-repos: Search for repositories on GitHub.

Prompts (5)

create-issue-description: Generate a description for a GitHub issue.
create-pull-request-description: Generate a description for a GitHub pull request.
search-repos-prompt: Generate a query for searching GitHub repositories.
create-issue-prompt: Generate parameters for creating a GitHub issue.
enhance-github-response: Format and enhance the raw GitHub API response data.