GitHub MCP Server

A Model Context Protocol server for interacting with the GitHub API.

Features

Tools

• list_user_repos: List repositories for the authenticated user

  • Parameters:
    • type (optional): "owner", "all", or "member" (default: "owner")
    • sort (optional): "created", "updated", "pushed", or "full_name" (default: "full_name")
    • direction (optional): "asc" or "desc" (default: "asc")
    • per_page (optional): Number of results per page (default: 30, max: 100)
    • page (optional): Page number (default: 1)

• get_repo: Get details about a specific repository

  • Parameters:
    • repo (required): The name of the repository
    • owner (optional): The account owner. If not provided, uses authenticated user.

• create_repo: Create a new repository

  • Parameters:
    • name (required): The name of the repository
    • description (optional): A short description
    • private (optional): Whether the repository is private (default: false)
    • auto_init (optional): Create initial commit with empty README (default: false)

• create_commit: Create a new commit with file changes

  • Parameters:
    • repo (required): The name of the repository
    • owner (optional): The account owner. If not provided, uses authenticated user.
    • branch (optional): The branch name (default: "main")
    • message (required): The commit message
    • files (required): Array of files to include in commit
      • Each file requires:
        • path: File path relative to repository root
        • content: File content

• push: Push changes to a remote repository

  • Parameters:
    • repo (required): The name of the repository
    • owner (optional): The account owner. If not provided, uses authenticated user.
    • branch (optional): The branch name (default: "main")

• pull: Pull changes from a remote repository

  • Parameters:
    • repo (required): The name of the repository
    • owner (optional): The account owner. If not provided, uses authenticated user.
    • branch (required): The branch name

Requirements

• Node.js 18+
• GitHub personal access token with appropriate permissions
• Set GITHUB_TOKEN environment variable

Installation

npm install
npm run build

Configuration

Set your GitHub token as an environment variable:

export GITHUB_TOKEN=your_token_here

Usage

Run the server:

npm start

Development

For development with auto-rebuild:

npm run watch

Debugging

Use the MCP Inspector:

npm run inspector