# 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

```bash
npm install
```

### 3. Build the Project

```bash
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:

```json
{
  "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
```bash
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