# GitHub MCP Server

Get GitHub repo stats, search repositories, analyze languages, and compare projects side-by-side. Comprehensive GitHub data and metrics.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nexgendata-apify/github-mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list nexgendata-apify/github-mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nexgendata-apify/github-mcp-server get_repo_stats

# Call a tool
npx -y @smithery/cli@latest tool call nexgendata-apify/github-mcp-server get_repo_stats '{}'
```

## Direct MCP Connection

Endpoint: `https://github-mcp-server--nexgendata-apify.run.tools`

**Optional config:**
- `apiKey` (query) — Your Apify API token for authenticated access. Get it from https://console.apify.com/settings/integrations. Required for data retrieval; optional for server discovery and capability listing.

## Tools (4)

- `get_repo_stats` — Fetch comprehensive statistics for a specific GitHub repository. Returns total stars, forks, issues (open/closed), pull…
- `search_repos` — Search across GitHub for repositories matching keywords, sorted by relevance or metrics. Returns matching repositories …
- `get_repo_languages` — Analyze the programming language composition of a GitHub repository. Returns percentage breakdown of languages used, do…
- `compare_repos` — Compare multiple GitHub repositories side-by-side with key metrics. Returns star counts, fork counts, issues, primary l…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nexgendata-apify/github-mcp-server <tool-name>
```

## Resources

- `github://api-info` — Supports repository stats, search, language analysis, and multi-repo comparison.

## Prompts (2)

- `repo_comparison` (repos) — Compare GitHub repositories side-by-side with stars, forks, languages, and activity metrics.
- `project_evaluation` (repo) — Evaluate an open-source project for quality, activity, and community health.
