GitHub MCP Server

An MCP server implementation that enables Claude to interact with GitHub repositories through the GitHub API.

Installation

npm install @microagents/server-github
# or
yarn add @microagents/server-github

Usage

Direct Execution

# Set your API token and run
GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here npx @microagents/server-github

With Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["@microagents/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
      }
    }
  }
}

Setup

Personal Access Token

Create a GitHub Personal Access Token with appropriate permissions:

1. Go to Personal access tokens (in GitHub Settings > Developer settings)
2. Select which repositories you'd like this token to have access to (Public, All, or Select)
3. Create a token with the repo scope ("Full control of private repositories")
   • Alternatively, if working only with public repositories, select only the public_repo scope
4. Copy the generated token

Features

• File Operations: Create, read, update, and delete files
• Repository Management: Create repositories, list branches, manage issues and PRs
• Search Functionality: Search code, repositories, issues, and users
• Git Operations: Commit changes, create branches, and more

Tools

File Operations

• create_or_update_file: Create or update a single file in a repository
• push_files: Push multiple files in a single commit
• get_file_contents: Get contents of a file or directory

Repository Management

• create_repository: Create a new GitHub repository
• search_repositories: Search for GitHub repositories
• list_branches: List branches in a repository
• create_branch: Create a new branch in a repository

Issues and Pull Requests

• create_issue: Create a new issue
• get_issue: Get details of a specific issue
• create_issue_comment: Add a comment to an issue
• create_pull_request: Create a new pull request
• get_pull_request: Get details of a specific pull request
• merge_pull_request: Merge a pull request

Search

• search_code: Search for code across GitHub repositories
• search_issues: Search for issues and pull requests
• search_users: Search for GitHub users

License

MIT

Credits

Based on the original MCP server by the Model Context Protocol team.