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 .env file 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 GitHubAPIClient class in github_tools.py
Register the tool with the MCP server in server.py using the @server.tool decorator
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

License

MIT License

Integrations