GitHub Repository Analyzer MCP Server
A Model Context Protocol (MCP) server that enables Large Language Models to analyze GitHub repositories in real-time. This server provides tools for retrieving repository information, analyzing issues, accessing documentation, and visualizing activity.
Features
- Repository Information Tool: Retrieve basic metadata about GitHub repositories
- Issue Analysis Tool: List and categorize repository issues
- README Access Resource: Access repository documentation
- Commit History Tool: Analyze recent code changes
- Activity Analysis Tool: Calculate repository activity metrics
- Visualization Tool: Create visual charts of repository activity
Prerequisites
- Python 3.10 or higher
- GitHub account and Personal Access Token
Installation
- Clone this repository:
git clone <repository-url>
cd github-repo-analyzer
- Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- Install dependencies:
pip install -r requirements.txt
- Create a
.envfile with your GitHub API token:
cp .env.example .env
Edit the .env file and replace your_github_token_here with your actual GitHub Personal Access Token.
Usage
Running the Server
To start the server in development mode with the MCP Inspector:
mcp dev src/server.py
This will open a web interface in your browser where you can test the server's tools.
Registering with Claude Desktop
To register the server with Claude Desktop:
mcp install src/server.py
After registering, restart Claude Desktop. You can then interact with the GitHub Repository Analyzer by asking Claude questions about GitHub repositories.
Example Prompts for Claude
- "Can you analyze the GitHub repository 'modelcontextprotocol/python-sdk' and tell me about its purpose and activity level?"
- "What are the top 5 open issues in the 'openai/openai-python' repository?"
- "How active has the 'anthropics/anthropic-sdk-python' repository been in the last 30 days?"
- "Please read the README of the 'microsoft/TypeScript' repository and explain its main features."
- "Generate a chart showing the commit activity for 'facebook/react' over the last 60 days."
Development
Project Structure
github-repo-analyzer/
├── src/
│ ├── github_tools.py # GitHub API client implementation
│ └── server.py # MCP server implementation
├── requirements.txt # Dependencies
├── .env.example # Example environment variables
├── .gitignore # Git ignore file
└── README.md # Project documentation
Adding New Tools
To add a new tool to the server, follow these steps:
- Add the necessary functionality to the
GitHubAPIClientclass ingithub_tools.py - Register the tool with the MCP server in
server.pyusing the@server.tooldecorator - Test the tool using the MCP Inspector
Testing
To test the server, use the MCP Inspector as described in the Usage section. You can also write unit tests for the GitHub API client functionality.
Security Considerations
- Never commit your GitHub API token to version control
- Use the minimum required scopes for your GitHub token
- Be mindful of GitHub API rate limits