github-stats-mcp

6rz6/github-stats-mcp

3.2

If you are the rightful owner of github-stats-mcp 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.

The GitHub Stats MCP Server is a Model Context Protocol server designed to provide tools for accessing various statistics related to GitHub repositories and users.

Tools

  1. get_repository_info

    Fetch detailed information about a specific repository.

  2. get_user_info

    Retrieve information about a specific GitHub user.

  3. get_repository_contributors

    List contributors to a repository with their contribution counts.

  4. get_repository_issues

    Browse issues and pull requests for a repository.

  5. search_repositories

    Search for repositories using specific keywords and criteria.

GitHub Stats MCP Server

A Model Context Protocol (MCP) server that provides tools for accessing GitHub repository and user statistics.

Features

  • Repository Information: Get detailed information about any public repository
  • User Statistics: Fetch user profiles and statistics
  • Contributors: List repository contributors with contribution counts
  • Issues: Browse repository issues and pull requests
  • Search: Search for repositories by keywords

Installation

Prerequisites

  • Node.js 18 or higher
  • npm or yarn

Install Dependencies

npm install
npm run build

GitHub Token (Optional)

For higher rate limits, create a GitHub personal access token:

  1. Go to GitHub Settings → Developer settings → Personal access tokens
  2. Create a token with public_repo scope (for public repositories)
  3. Set the token as an environment variable: GITHUB_TOKEN=your_token_here

Usage

As a Local MCP Server

Add to your MCP configuration file:

{
  "mcpServers": {
    "github-stats": {
      "command": "node",
      "args": ["/path/to/github-stats-mcp/build/index.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_optional"
      }
    }
  }
}

Available Tools

1. Get Repository Information
{
  "tool": "get_repository_info",
  "arguments": {
    "owner": "microsoft",
    "repo": "vscode"
  }
}
2. Get User Information
{
  "tool": "get_user_info",
  "arguments": {
    "username": "octocat"
  }
}
3. Get Repository Contributors
{
  "tool": "get_repository_contributors",
  "arguments": {
    "owner": "microsoft",
    "repo": "vscode",
    "limit": 10
  }
}
4. Get Repository Issues
{
  "tool": "get_repository_issues",
  "arguments": {
    "owner": "microsoft",
    "repo": "vscode",
    "state": "open",
    "limit": 20
  }
}
5. Search Repositories
{
  "tool": "search_repositories",
  "arguments": {
    "query": "language:typescript stars:>1000",
    "sort": "stars",
    "limit": 10
  }
}

Development

Build the Server

npm run build

Development Mode

npm run dev

API Rate Limits

  • Without token: 60 requests per hour
  • With token: 5,000 requests per hour

License

MIT