GitHub

You have a production-ready MCP server that exposes 28+ GitHub analysis tools via a fast, scalable interface. It lets you query repository data, commits, issues, files, searches, users, releases, workflows, and utilities, all through MCP requests. This guide shows you how to use the server efficiently, install it, and configure it for local development or remote deployment.

How to use

Connect to the MCP server from your MCP client and call any of the available tools to fetch data from GitHub. You can run analyses on public repositories with a GitHub token for higher rate limits and broader access. Start by starting the server, then send tool requests to retrieve repository info, language distributions, contributor rankings, issue data, search results, user activity, and more. Use the tool names exactly as listed in the available tools to perform the desired operations.

How to install

# Prerequisites
python3 --version
pip --version

# Install dependencies
pip install fastmcp httpx python-dotenv

# Run the MCP server
python github_server.py

Configuration and runtime notes

The server supports HTTP-based external access and local stdio operation. Use the following options to connect from your MCP client or GUI tools.

{
  "mcpServers": {
    "github_pro": {
      "type": "http",
      "url": "http://localhost:8001/mcp/v1",
      "args": []
    }
  }
}

Available tools

get_repository_info

Fetches complete repository metadata with statistics for a given owner and repository.

get_repository_languages

Returns a breakdown of languages used in the repository with percentage usage.

get_repository_contributors

Lists top contributors with contribution counts.

get_repository_tags

Retrieves release tags for the repository.

get_repository_branches

Provides branch information including protection status.

get_repository_stats

Delivers comprehensive analytics for a repository.

get_repository_traffic

Returns views and clones data (requires permissions).

get_repository_community

Returns health score and community-related files.

get_repository_commits

Gets commit history with authors.

get_commit_details

Provides detailed information for a specific commit.

compare_commits

Compares two commits or branches.

get_repository_issues

Filters issues by state and labels.

get_pull_requests

Retrieves PR details including merge status.

get_issue_comments

Fetches comments for an issue or PR.

get_file_content

Reads a file's content from the repository.

get_directory_contents

Browses directory contents of the repository.

get_repository_readme

Fetches the repository README quickly.

search_code

Searches for code across repositories.

search_repositories

Performs advanced repository searches.

search_users

Finds users and organizations.

search_topics

Discovers GitHub topics.

get_trending_repositories

Provides hot repositories by language.

get_trending_developers

Shows active developers by trend.

get_user_profile

Returns complete user information.

get_user_repositories

Lists a user's public repositories.

get_user_activity

Shows recent user activity.

get_organization_info

Retrieves organization details.

get_releases

Lists releases with download stats.

get_latest_release

Fetches details of the latest release.

get_workflows

Lists GitHub Actions workflows for a repo.

get_workflow_runs

Shows recent workflow execution history.

get_rate_limit

Checks current API rate limit status.

server_info

Returns server capabilities and statistics.