Integrations

Provides tools for interacting with GitHub's API, enabling repository creation, pushing content to repositories, and retrieving user information.

GitHub MCP Server

A Model Context Protocol (MCP) server implementation for GitHub integration. This server provides tools for interacting with GitHub's API through the MCP protocol.

Features

Create GitHub repositories
Push content to repositories
Get user information
Proper error handling and TypeScript type safety
Automatic installation script

Prerequisites

Node.js (v18 or higher)
npm (v8 or higher)
PowerShell (for Windows installation)
GitHub Personal Access Token with repo scope

Installation

Windows

Clone this repository:

git clone https://github.com/oghenetejiriorukpegmail/github-mcp.git

Run the installation script:

.\install.ps1

The script will:

Create the necessary directories
Install dependencies
Build the TypeScript code
Configure the MCP settings

Manual Installation

Create the MCP directory:

mkdir -p "$env:APPDATA\Roo-Code\MCP\github-mcp"

Clone this repository into that directory:

git clone https://github.com/oghenetejiriorukpegmail/github-mcp.git "$env:APPDATA\Roo-Code\MCP\github-mcp"

Install dependencies:

cd "$env:APPDATA\Roo-Code\MCP\github-mcp"
npm install

Build the TypeScript code:

npm run build

Add the server configuration to your MCP settings file at: %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": [
        "%APPDATA%\Roo-Code\MCP\github-mcp\build\index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "your-github-token-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Available Tools

get_user

Get GitHub user information.

{
  "username": "octocat"
}

create_repo

Create a new GitHub repository.

{
  "repo_name": "my-new-repo",
  "description": "A new repository",
  "private": false
}

push_to_repo

Push content to a GitHub repository.

{
  "repo_name": "my-repo",
  "file_path": "docs/README.md",
  "content": "# My Project\nThis is a test file.",
  "message": "Add README file"
}

Development

Clone the repository
Install dependencies: npm install
Make changes to src/index.ts
Build: npm run build
Test your changes

Contributing

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Create a Pull Request

License

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Provides tools for interacting with GitHub's API through the MCP protocol, allowing users to create repositories, push content, and retrieve user information.