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