Jehan26/MCP-Inspector-v0.6.0
If you are the rightful owner of MCP-Inspector-v0.6.0 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 Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.
MCP-Inspector-v0.6.0
GitHub MCP Server
A Model Context Protocol (MCP) server that enables AI assistants like Claude to interact with GitHub repositories, issues, and pull requests.
Features
- Repository Search: Find GitHub repositories based on search queries
- Issue Management: Get, create, and comment on issues
- Pull Request Handling: View and manage pull requests
- Repository Analysis: Get statistics and insights about repositories
Installation
Prerequisites
- Python 3.8+
- GitHub API token
Steps
-
Clone this repository:
git clone https://github.com/yourusername/github-mcp-server.git cd github-mcp-server -
Install dependencies:
pip install -r requirements.txt -
Set up your GitHub token as an environment variable:
export GITHUB_TOKEN=your_github_token_here -
Run the server:
python server.py
The server will start running on http://localhost:5000.
Usage
Endpoints
The MCP server provides the following endpoints:
- GET /mcp/discover: Returns available operations and their parameters
- POST /mcp/execute: Executes operations based on provided parameters
Example Requests
Discovery
curl -X GET http://localhost:5000/mcp/discover
Execute Repository Search
curl -X POST http://localhost:5000/mcp/execute \
-H "Content-Type: application/json" \
-d '{
"endpoint": "search_repositories",
"parameters": {
"query": "machine learning"
}
}'
Get Repository Issues
curl -X POST http://localhost:5000/mcp/execute \
-H "Content-Type: application/json" \
-d '{
"endpoint": "get_repo_issues",
"parameters": {
"owner": "openai",
"repo": "whisper"
}
}'
Architecture
The server follows the Model Context Protocol specification to allow AI assistants to:
- Discover available operations
- Execute operations with appropriate parameters
- Process and return results in a structured format
Extending the Server
You can extend this server by:
- Adding new endpoints in the
discover()function - Implementing corresponding handler functions
- Updating the routing in the
execute()function
Security Considerations
- The server uses an API token for authentication with GitHub
- Implement rate limiting to prevent abuse
- Add input validation for all parameters
- Consider implementing OAuth for more secure token management
Demo
See the demo video for a walkthrough of the server's capabilities.
License
MIT License
Contact
For questions or support, please open an issue on this repository.
