GitHub MCP (Model Context Protocol) server
@ualUsham
This is a GitHub MCP server designed to enable MCP-compatible LLMs, such as Claude, to communicate with my MCP server and interact with the GitHub API.
Overview
What is GitHub MCP (Model Context Protocol) server?
A server that enables MCP-compatible LLMs like Claude to interact with the GitHub API. It provides predefined tools and prompts for common GitHub operations.
How to use GitHub MCP (Model Context Protocol) server?
Clone the repository, run npm install, add a .env file, build with npx tsc, then run node build/index.js. Configure Claude Desktop by editing claude_desktop_config.json to point to the built index.js and set a GITHUB_TOKEN environment variable. You can also test using the MCP inspector.
Key features of GitHub MCP (Model Context Protocol) server
- Create, list, and describe GitHub issues
- Retrieve repository information and search repositories
- Generate descriptions for issues and pull requests
- Format and enhance raw GitHub API responses
- Integrates with MCP-compatible LLMs via Model Context Protocol
Use cases of GitHub MCP (Model Context Protocol) server
- Allow an LLM assistant to create GitHub issues on your behalf
- Fetch repository details and issue lists during conversations
- Search for GitHub repositories based on user queries
- Generate pull request or issue descriptions automatically
FAQ from GitHub MCP (Model Context Protocol) server
What does this server do?
It acts as a bridge between an MCP-compatible LLM (e.g., Claude) and the GitHub API, providing tools and prompts to interact with GitHub repositories.
What are the requirements to run it?
You need TypeScript, Octokit, and the Model Context Protocol SDK. Node.js is required to execute the built JavaScript.
How do I configure it with Claude Desktop?
Add an entry to your claude_desktop_config.json file with the command node, the absolute path to your index.js file, and set the GITHUB_TOKEN environment variable to your GitHub personal access token.
What tools and prompts does it include?
Four tools: create-issue, get-repo-info, list-issues, search-repos. Five prompts: create-issue-description, create-pull-request-description, search-repos-prompt, create-issue-prompt, and enhance-github-response.
How can I test the server without Claude Desktop?
Use the MCP inspector: run npx @modelcontextprotocol/inspector node build/index.js and open http://localhost:5173.
