Github MCP

🚀 GitHub Manager MCP Server

A TypeScript-based MCP server that provides tools to manage GitHub organizations, repositories, and collaborators via the GitHub API.

🚀 Quick Start

This is a TypeScript-based MCP server that offers tools to manage GitHub organizations, repositories, and collaborators through the GitHub API.

✨ Features

GitHub Management Tools

• list_orgs: List GitHub organizations to which the authenticated user belongs.
• list_repos: List repositories within a specified organization.
• create_repo: Create a new repository in an organization.
• add_collaborator: Add a collaborator to a repository.
• update_repo_settings: Update repository settings.

📦 Installation

npm install

🚧 Build

npm run build

🔄 Development with Automatic Rebuild

npm run watch

🧪 Testing

Run unit tests:

npm test

Run tests with coverage:

npm run test:coverage

⚙️ Configuration

Environment Variables

• GITHUB_TOKEN: A GitHub personal access token with the required scopes.

MCP Server Installation

To use with Claude Desktop, add the following configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "github-manager": {
      "command": "/path/to/github-manager/build/index.js",
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

🐞 Debugging

We recommend using MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access the debugging tools. Open it in your browser.