GitHub MCP Server
About
A MCP Server with tools for interfacing with Discussions on Github
Details
- Author
- jasona7
- Downloads
- 532
- Categories
- Developer Tools, Automation
Jump to
- Repository management and advanced search
- GitHub Discussions integration
- Activity analysis and trending repos
- Terminal UI client for exploration
- Configurable host and port via environment variables
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
GitHub MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
After installing dependencies (pip install requests) and setting the GITHUB_TOKEN environment variable, start the server with python scripts/mcp/github/mcp_github_server.py. Use the included client (python scripts/mcp/github/mcp_github_client.py) to interact via a terminal UI or call the exposed tools directly.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"github mcp server": {
"mcp_github_discussions": {
"command": "python",
"args": [
"scripts/mcp/github/mcp_github_server.py"
]
}
}
}
}
McpServers
{
"mcp_github_discussions": {
"command": "python",
"args": [
"scripts/mcp/github/mcp_github_server.py"
]
}
}
GitHub MCP Server
A versatile and powerful server implementation of the Model Context Protocol (MCP), designed to seamlessly interact with GitHub repositories, issues, discussions, and beyond. This server enables efficient management, automation, and enhanced collaboration by providing a structured interface to query, update, and analyze GitHub data. With support for integrating custom workflows, handling repository metadata, and facilitating real-time interactions with issues and discussions, the MCP server empowers developers and teams to streamline their GitHub experience. Whether you're building tools, automating tasks, or exploring new ways to engage with GitHub's ecosystem, this server offers a robust foundation for your projects.
Overview
This MCP server provides a bridge between AI assistants and the GitHub API, allowing AI models to perform actions like:
- Searching repositories
- Viewing discussions
- Analyzing repository activity
- Fetching repository statistics
Features
- Repository Management: Search, analyze, and interact with GitHub repositories
- Discussion Integration: Analyze GitHub Discussions
- Activity Analysis: Get insights on repository activity and contributions
- Search Capabilities: Advanced search for repositories, code, and discussions
Installation
Prerequisites
- Python 3.8+
- GitHub Personal Access Token with appropriate permissions
Setup
1. Clone the repository:
git clone https://github.com/jasona7/mcp_github_discussions.git
cd mcp_github_discussions
2. Install dependencies:
pip install requests
3. Set up your GitHub token in the environment variable:
export GITHUB_TOKEN=your_github_personal_access_token
Usage
Starting the Server
Run the server with:
python scripts/mcp/github/mcp_github_server.py
The server will start on localhost:8004 by default.
Available Tools
The server provides the following tools:
- search_repositories: Search for repositories based on various criteria
- get_repository_details: Get detailed information about a repository
- get_repository_issues: Fetch issues from a repository
- get_repository_discussions: Fetch discussions from a repository
- get_top_repos_by_activity: Get trending repositories by activity
Configuration
The server can be configured using environment variables:
- GITHUB_TOKEN: Your GitHub Personal Access Token
- MCP_HOST: Host to bind the server to (default: localhost)
- MCP_PORT: Port to bind the server to (default: 8004)
Using the Client
python scripts/mcp/github/mcp_github_client.py
╭──────────────────────────────── GitHub Discussions Explorer ────────────────────────────────╮
│ MCP GitHub Discussions Explorer │
│ A terminal UI for interacting with GitHub Discussions │
╰─────────────────────────────────────────────────────────────────────────────────────────────╯
Connecting to server...
Connected to server. 5 tools available.
Available Actions:
1. Browse Top Repositories
2. List Discussions (by repo)
3. Get Discussion Details
4. Check Server Status
5. Exit
6. Toggle Debug Mode
Enter the number of the action you want to perform [1/2/3/4/5/6] (1): 1
Browse Top Repositories:
1. Top Repos by Recent Activity
2. Top Repos by Star Count
3. Top Python Repos
4. Top JavaScript Repos
5. Top AI/LLM Repos
6. Back to Main Menu
Select repository category [1/2/3/4/5/6] (1): 3
Number of repositories to show (10): 3
Finding top Python repositories...
Top Repositories (3)
┏━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━━━━┓
┃ # ┃ Repository ┃ Stars ┃ Language ┃ Has Discussions ┃
┡━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━━━━┩
│ 1 │ public-apis/public-apis │ 334406 │ Python │ ✗ │
│ 2 │ donnemartin/system-design-primer │ 294897 │ Python │ ✗ │
│ 3 │ vinta/awesome-python │ 238668 │ Python │ ✗ │
└───┴──────────────────────────────────┴────────┴──────────┴─────────────────┘
None of the repositories have discussions enabled.
Available Actions:
1. Browse Top Repositories
2. List Discussions (by repo)
3. Get Discussion Details
4. Check Server Status
5. Exit
6. Toggle Debug Mode
Enter the number of the action you want to perform [1/2/3/4/5/6] (1):
Troubleshooting
- Connection Refused: Make sure the server is running and the port is not blocked by a firewall
- Authentication Errors: Verify your GitHub token has the necessary permissions
- Rate Limiting: GitHub API has rate limits; the server will handle these but may slow down during heavy usage
License
MIT License - see the LICENSE file for details
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


