GitHub Repository Manager MCP Server

A Model Context Protocol (MCP) server that allows AI assistants to create and delete GitHub repositories.

Features

• ✅ Create GitHub repositories with customizable settings
• ✅ Delete GitHub repositories (permanent deletion)
• ✅ MCP protocol compliant - works with Claude Desktop and other MCP clients
• ✅ Simple setup - just configure and restart your AI assistant
• ✅ Secure - uses environment variables for sensitive data

Quick Start

1. Install Dependencies

pip install -r requirements.txt

2. Set Up Your GitHub Token

1. Go to GitHub Settings > Tokens

2. Generate a new token with "repo" permissions

3. Copy the token

3. Create Environment File

Create a `.env` file in the same directory as `simple_mcp_server.py`:

# .env file
GITHUB_TOKEN=your_actual_github_token_here

⚠️ Important: Never commit your `.env` file to Git! It contains sensitive information.

4. Configure Claude Desktop

1. Open: `~/Library/Application Support/Claude/config.json`

2. Replace the content with:

{
  "darkMode": "dark",
  "scale": 0,
  "mcpServers": {
    "github-repo-creator": {
      "command": "python3",
      "args": ["/path/to/your/simple_mcp_server.py"],
      "env": {}
    }
  }
}

Note: No need to set `GITHUB_TOKEN` in the config anymore - it's loaded from the `.env` file.

5. Restart Claude Desktop

• Quit and reopen Claude Desktop

6. Test It!

Ask Claude:

• "What tools do you have available?"
• "Create a repository called 'my-test-repo'"
• "Delete the repository called 'my-test-repo'"

Available Tools

`create_github_repository`

Creates a new GitHub repository.

Parameters:

• `name` (required): Repository name
• `private` (optional): Make it private (default: false)
• `description` (optional): Repository description
• `auto_init` (optional): Initialize with README (default: true)

`delete_github_repository`

Deletes an existing GitHub repository.

Parameters:

• `name` (required): Repository name to delete

Files

• `simple_mcp_server.py` - The MCP server implementation
• `requirements.txt` - Python dependencies
• `claude_config_example.json` - Example Claude Desktop configuration
• `.env.example` - Example environment file (copy to `.env` and add your token)
• `README.md` - This file

Security Notes

• ⚠️ Never commit your `.env` file to Git
• ⚠️ Never commit your real GitHub token to Git
• ⚠️ Repository deletion is permanent
• ✅ Use environment variables for sensitive data
• ✅ Regularly rotate your tokens
• ✅ Add `.env` to your `.gitignore` file

Environment Variables

The server uses these environment variables:

• `GITHUB_TOKEN` - Your GitHub personal access token (required)

Troubleshooting

"GITHUB_TOKEN not found" error

• Make sure you created a `.env` file
• Check that `GITHUB_TOKEN=your_token` is in the `.env` file
• Ensure the `.env` file is in the same directory as `simple_mcp_server.py`

"Repository not found" error

• Check that the repository name is correct (case-sensitive)
• Ensure your token has the right permissions
• Verify the repository exists in your account

MCP server not loading

• Check the file path in your config
• Ensure the script is executable: `chmod +x simple_mcp_server.py`
• Restart Claude Desktop after config changes

Example Usage

Once configured, you can ask Claude:

• "Create a private repository called 'secret-project' with description 'My secret project'"
• "Make a public repository named 'open-source-tool'"
• "Delete the repository called 'old-test-repo'"
• "What tools do you have available?"

License

MIT License - feel free to use and modify! # MCP-Repo-Manager-