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 buildGitHub Token (Optional)
For higher rate limits, create a GitHub personal access token:
- Go to GitHub Settings → Developer settings → Personal access tokens
- Create a token with
public_reposcope (for public repositories) - 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 buildDevelopment Mode
npm run devAPI Rate Limits
- Without token: 60 requests per hour
- With token: 5,000 requests per hour
License
MIT
