GitHub MCP Server

A Model Context Protocol (MCP) server that provides comprehensive GitHub integration for Claude Desktop.

Quick Setup

1. Get the Complete Source Code

The complete src/index.ts file (613 lines) is available in the files I shared with you. Look for the file named COMPLETE-INDEX-TS.txt.

To create the index.ts file:

1. Open the COMPLETE-INDEX-TS.txt file

2. Copy everything EXCEPT the first 3 comment lines

3. Save it as src/index.ts in this directory

Alternatively, you can download the complete src/index.ts from the original package files.

2. Install Dependencies

npm install

3. Build the Project

npm run build

4. Create GitHub Personal Access Token

1. Visit: https://github.com/settings/tokens/new

2. Name it: "Claude MCP Server"

3. Select scopes:

   • ✅ repo (Full control of private repositories - includes all sub-scopes)

   • ✅ user:read (Read user information)

   • ✅ read:org (Read organization data)

4. Click "Generate token"

5. Copy the token immediately

5. Configure Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "github": {
      "command": "node",
      "args": ["C:\\Users\\DavidFurry\\Documents\\Github-MCP-Claude-Desktop\\dist\\index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

Replace your_github_token_here with your actual GitHub token.

6. Restart Claude Desktop

Completely quit and restart Claude Desktop.

Features

✅ Repositories - List, get, create ✅ Issues - Full CRUD + comments ✅ Pull Requests - Create, merge, list ✅ Files - Read and write ✅ Branches - List and create ✅ Search - Repos, code, issues ✅ Users - Get user info

Usage Examples

Once installed:

List my GitHub repositories

Create a new repository called my-awesome-project

Search GitHub for TypeScript MCP servers

List open issues in facebook/react

Troubleshooting

Server not found

• Check the path in config is absolute and correct

• Verify dist/index.js exists

• Make sure you ran npm run build

Authentication failed

• Verify token is correct

• Check token hasn't expired

• Ensure token has correct scopes

Build fails

rm -rf node_modules dist
npm install
npm run build

Security

⚠️ Never commit your GitHub token to version control

• Keep your token secure

• Use minimal required permissions

• Set token expiration (90 days recommended)

License

MIT