Singularityent/mcp-custom-github-server
If you are the rightful owner of mcp-custom-github-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A comprehensive Model Context Protocol (MCP) server implementation for GitHub integration, providing powerful tools for repository management, issue tracking, and code analysis.
Custom GitHub MCP Server
A comprehensive Model Context Protocol (MCP) server implementation for GitHub integration, providing powerful tools for repository management, issue tracking, and code analysis.
Features
- Repository Management: Create, fork, search, and manage repositories
- Issue & PR Operations: Create, update, and manage issues and pull requests
- Code Analysis: Search code, get file contents, and analyze repositories
- Security Tools: Access code scanning, dependabot alerts, and security advisories
- Workflow Management: View and manage GitHub Actions workflows
- Notifications: Handle GitHub notifications and subscriptions
Installation
Prerequisites
- Node.js 18+ or Python 3.8+
- GitHub Personal Access Token with appropriate scopes
Setup
- Clone this repository:
git clone https://github.com/Singularityent/mcp-custom-github-server.git
cd mcp-custom-github-server
- Install dependencies:
npm install
# or
pip install -r requirements.txt
- Set up your GitHub token:
export GITHUB_PERSONAL_ACCESS_TOKEN="your_token_here"
- Run the server:
npm start
# or
python server.py
Configuration
The server can be configured through environment variables:
GITHUB_PERSONAL_ACCESS_TOKEN
: Your GitHub personal access tokenGITHUB_HOST
: GitHub hostname (default: api.github.com)LOG_LEVEL
: Logging level (default: info)PORT
: Server port (default: 3000)
Usage
With Cursor
Add to your ~/.cursor/mcp.json
:
{
"mcpServers": {
"github-custom": {
"command": "node",
"args": ["server.js"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}
With Claude Desktop
Add to your Claude Desktop configuration:
{
"mcpServers": {
"github-custom": {
"command": "node",
"args": ["server.js"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
}
}
}
}
Available Tools
Repository Tools
search_repositories
: Search for repositoriesget_repository
: Get repository detailscreate_repository
: Create a new repositoryfork_repository
: Fork an existing repository
Issue & PR Tools
list_issues
: List repository issuescreate_issue
: Create a new issueupdate_issue
: Update an existing issuelist_pull_requests
: List pull requestscreate_pull_request
: Create a new pull request
Code Tools
search_code
: Search code across repositoriesget_file_contents
: Get file contentslist_branches
: List repository branchescreate_branch
: Create a new branch
Security Tools
list_code_scanning_alerts
: List code scanning alertslist_dependabot_alerts
: List Dependabot alertslist_secret_scanning_alerts
: List secret scanning alerts
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
License
MIT License - see LICENSE file for details.
Support
For issues and questions, please open an issue on GitHub.