Github MCP Server 6gm

🚀 GitHub MCP Server

A Model Context Protocol (MCP) server that interacts with the GitHub API.

🚀 Quick Start

To start using the GitHub MCP Server, follow these steps:

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

✨ Features

Tools

• list_user_repos: List all repositories of 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 detailed information about a specific repository.

  • Parameters:
    • repo (required): Repository name
    • owner (optional): Account owner. If not provided, the authenticated user is used.

• create_repo: Create a new repository.

  • Parameters:
    • name (required): Repository name
    • description (optional): Short description
    • private (optional): Whether it's a private repository (default: false)
    • auto_init (optional): Create an initial commit with an empty README file (default: false)

• create_commit: Create a new commit containing file changes.

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

• push: Push changes to the remote repository.

  • Parameters:
    • repo (required): Repository name
    • owner (optional): Account owner. If not provided, the authenticated user is used.
    • branch (optional): Branch name (default: "main")

• pull: Pull changes from the remote repository.

  • Parameters:
    • repo (required): Repository name
    • owner (optional): Account owner. If not provided, the authenticated user is used.
    • branch (required): Branch name

📦 Requirements

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