GitHub Repository Analyzer

Provides tools to fetch repo metadata, analyze issues, read READMEs, review commits, measure activity, and visualize GitHub repository activity.

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jar285-github_mcp_analyzer": {
      "command": "mcp",
      "args": [
        "dev",
        "src/server.py"
      ]
    }
  }
}

You can run and interact with the GitHub Repository Analyzer MCP Server to retrieve repository metadata, analyze issues, access documentation, review commit history, measure activity, and visualize repository trends. This MCP server is designed to help you explore GitHub projects from a conversational interface or through MCP-enabled clients, giving you actionable insights across multiple data sources.

How to use

You connect to the MCP server using an MCP-enabled client. Start the server in development mode to access its web interface and testing tools, or register it with your MCP client to enable question-driven interactions.

Practical usage patterns you can perform include: retrieving basic repository metadata, listing and categorizing issues, reading the repository README, reviewing recent commits, calculating activity metrics, and generating visual charts of activity over time.

To start testing with an MCP client, run the development command and then open the web interface in your browser. You can test individual tools by asking questions such as about a repository’s purpose, activity level, or top open issues.

If your MCP client supports automatic tool registration, you can register the server and then begin querying across the available tools. This enables seamless, language-assisted exploration of GitHub repositories.

How to install

Prerequisites you need before installation: Python 3.10 or higher and a GitHub account with a Personal Access Token.

Step-by-step commands you should run in order:

# 1) Install dependencies and set up environment
# Clone the project
 git clone <repository-url>
 cd github-repo-analyzer

# 2) Create and activate a virtual environment
 python -m venv venv
 source venv/bin/activate  # On Windows: venv\Scripts\activate

# 3) Install dependencies
 pip install -r requirements.txt

# 4) Prepare environment file with your GitHub token
 cp .env.example .env
 # Edit the .env file and replace YOUR_GITHUB_TOKEN with your token

Available tools

Repository Information Tool

Retrieves basic metadata about GitHub repositories such as owner, name, description, stars, forks, and primary language.

Issue Analysis Tool

Lists and categorizes repository issues, enabling discovery of open, closed, and labeled issues with summaries.

README Access Resource

Provides access to repository documentation and README content to understand project scope and usage.

Commit History Tool

Analyzes recent code changes, showing commit activity, authors, and timelines.

Activity Analysis Tool

Calculates activity metrics over a selected period to help you gauge project momentum.

Visualization Tool

Generates visual charts of repository activity to illustrate trends over time.