GitHub MCP Setup

This repository contains the configuration for GitHub MCP (Model Context Protocol) integration with AI tools like Claude.

Setup Instructions

1. Generate a GitHub Personal Access Token:

   • Go to GitHub Personal Access Tokens
   • Click on "Generate new token" (classic)
   • Give your token a descriptive name like "MCP Access"
   • Select the necessary scopes:
     • For full access to private repositories, select repo
     • For access to public repositories only, select public_repo
   • Click "Generate token"
   • Copy the generated token (you won't be able to see it again!)

2. Set the Environment Variable:

   export GITHUB_PERSONAL_ACCESS_TOKEN="your_token_here"
   

   For permanent setup, add this to your shell profile file (~/.zshrc, ~/.bash_profile, etc.)

   Alternatively, use the provided setup script:

   ./setup-token.sh
   

3. Verify the Installation:

   • Run the test script:

   ./test-mcp.js
   

   • Or open Claude Desktop or your AI assistant
   • Start a new conversation
   • Ask it to perform a GitHub-related task
   • If properly set up, the AI should be able to interact with your GitHub repositories

Managing GitHub Accounts

If you need to switch between different GitHub accounts, you can use the account manager script:

./github-account-manager.sh

This script provides the following options:

1. Check current login status
2. Logout from GitHub
3. Login to GitHub with a new account
4. Exit

The script will:

• Help you logout by removing your current token
• Allow you to login with a different account's token
• Check who you're currently logged in as
• Update your shell configuration if needed

Advanced: Multi-Repository Configuration

For working with multiple Git repositories, you can use the advanced configuration:

1. Copy the multi-repo-config.json file to ~/.cursor/mcp.json:

   cp multi-repo-config.json ~/.cursor/mcp.json
   

2. Edit the configuration to point to your actual repositories:

   {
     "mcpServers": {
       "github-main": {
         "command": "mcp-github",
         "args": []
       },
       "git-repo1": {
         "command": "uvx",
         "args": [
           "mcp-server-git",
           "--repository", "/path/to/your/repo1"
         ]
       }
     }
   }
   

3. When interacting with your AI assistant, specify which repository you want to work with:

   • "Show me commits in my git-repo1 repository"
   • "Check recent changes in github-main"

Usage Examples

• "Show me my GitHub repositories"
• "Check the latest commits in my repository X"
• "Create a new issue in my repository Y"
• "Show me open pull requests"
• "Clone repository Z to my local machine"

Troubleshooting

If you encounter issues:

1. Verify your token has the correct permissions
2. Check that the environment variable is properly set (run echo $GITHUB_PERSONAL_ACCESS_TOKEN)
3. Restart your AI assistant application
4. Ensure the MCP server is properly configured
5. Run the test script to verify the installation: ./test-mcp.js