Universal GitHub MCP Server
Provides tools for managing GitHub repositories, branches, pull requests, and files via the GitHub API, with support for multi-repository configuration and company documentation enforcement.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Universal GitHub MCP Servershow open pull requests for my-frontend"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Universal GitHub MCP Server
A configurable Model Context Protocol (MCP) server that provides GitHub API integration for any repositories you specify.
π Features
Pure GitHub API Operations - No local file dependencies
Multi-Repository Support - Work with multiple GitHub repositories
Configurable - Easily configure for your own repositories
Branch Management - Create, list, and manage branches
Pull Request Operations - Create and manage PRs
File Operations - Read and update files via GitHub API
π Company Documentation Integration - Enforces company rules and best practices
π Automatic Validation - Validates branch names, PR formats according to your guidelines
π Smart Documentation Search - Find specific rules and guidelines quickly
Related MCP server: Git MCP Server
π Available Actions
GitHub Actions
Action | Description |
| Show all configured repositories |
| List branches in a repository |
| Create a new branch (with validation) |
| List open pull requests |
| Create a pull request (with template) |
| Get file content from repository |
| Update file content in repository |
Documentation Actions
Action | Description |
| Show all available company documentation |
| Get specific documentation (git, coding, review, pr) |
| Search through documentation for specific terms |
| Get company rules for specific categories |
| Get action-specific guidelines |
βοΈ Configuration
Method 1: Environment Variable (Recommended)
Set the GITHUB_REPOS environment variable with your repository configuration:
export GITHUB_REPOS='[
{
"name": "my-frontend",
"repo": "myusername/frontend-app",
"defaultBranch": "main"
},
{
"name": "my-backend",
"repo": "myusername/backend-api",
"defaultBranch": "develop"
}
]'Method 2: Configuration File
Edit config/repos.json:
{
"repositories": [
{
"name": "my-project",
"repo": "owner/repository-name",
"defaultBranch": "main"
},
{
"name": "another-project",
"repo": "owner/another-repo",
"defaultBranch": "develop"
}
]
}π GitHub Token Setup
Generate a Personal Access Token:
Go to GitHub β Settings β Developer settings β Personal access tokens
Generate new token with
repopermissions
Set the token as environment variable:
export GITHUB_TOKEN="your_github_token_here"πββοΈ Running the Server
# Install dependencies
npm install
# Set your GitHub token
export GITHUB_TOKEN="your_token_here"
# Optional: Set custom repositories
export GITHUB_REPOS='[{"name":"my-repo","repo":"owner/repo","defaultBranch":"main"}]'
# Start the MCP server
npm start
# or
node index.jsπ§ Claude Desktop Integration
Add to your Claude Desktop config.json:
{
"mcpServers": {
"github-mcp": {
"command": "node",
"args": ["/path/to/your/github-mcp/index.js"],
"env": {
"GITHUB_TOKEN": "your_github_token_here",
"GITHUB_REPOS": "[{\"name\":\"my-repo\",\"repo\":\"owner/repo\",\"defaultBranch\":\"main\"}]"
}
}
}
}π Usage Examples
List Configured Repositories
{
"repoName": "any-repo-name",
"action": "list_repos"
}Create a New Branch
{
"repoName": "my-frontend",
"action": "create_branch",
"taskBranch": "feature/new-component",
"taskDescription": "Add new React component"
}Get File Content
{
"repoName": "my-backend",
"action": "get_file",
"taskDescription": "src/server.js"
}List Pull Requests
{
"repoName": "my-frontend",
"action": "list_prs"
}π Security Notes
Never commit your GitHub token to version control
Use environment variables for sensitive configuration
The server only requires
repopermissions for private repositoriesFor public repositories, you can use a token with minimal permissions
π Development
# Clone the repository
git clone <your-repo-url>
cd github-mcp
# Install dependencies
npm install
# Create your configuration
cp config/repos.json.example config/repos.json
# Edit config/repos.json with your repositories
# Set environment variables
export GITHUB_TOKEN="your_token"
# Run the server
npm startπ Example Configuration Files
For Open Source Projects
{
"repositories": [
{
"name": "react",
"repo": "facebook/react",
"defaultBranch": "main"
},
{
"name": "vue",
"repo": "vuejs/vue",
"defaultBranch": "dev"
}
]
}For Company Projects
{
"repositories": [
{
"name": "web-app",
"repo": "company/web-application",
"defaultBranch": "develop"
},
{
"name": "mobile-app",
"repo": "company/mobile-app",
"defaultBranch": "main"
},
{
"name": "api-service",
"repo": "company/api-service",
"defaultBranch": "master"
}
]
}π― Default Behavior
If no configuration is found, the server will use example configuration and show helpful error messages to guide you through setup.
π Support
Check the server logs for configuration loading messages
Use the
list_reposaction to verify your configurationEnsure your GitHub token has the necessary permissions
Ready to use with your own repositories! π
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceAn MCP server that enables Git repository operations and GitHub PR workflows, allowing users to manage repositories, create branches, commit changes, and create pull requests through natural language.2
- AlicenseBqualityDmaintenanceA modular MCP server that provides a unified interface for interacting with GitHub and GitLab, including enterprise and self-hosted instances. It enables comprehensive management of repositories, issues, pull requests, and CI/CD pipelines through natural language.2350MIT
- Flicense-qualityDmaintenanceStandalone MCP server for GitHub that enables repository management, branch operations, pull request handling, and commit retrieval via tools listed in the README.1
- AlicenseCqualityBmaintenanceA production-ready MCP server for GitHub operations, providing tools for repository management, issues, pull requests, and more via both MCP stdio and REST API.27MIT
Related MCP Connectors
A MCP server built for developers enabling Git based project management with project and personalβ¦
An MCP server that gives your AI access to the source code and docs of all public github repos
The MCP server for Azure DevOps, bringing the power of Azure DevOps directly to your agents.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/nasimcoderex/tasker-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server