# github-mcp-server MCP server

GitHub repo analytics: stars, trending, code search, contributor maps for project research.

## At a glance

github-mcp-server is an MCP server in the Dev Tools & Git category. It is hosted remotely and connects over HTTP, and needs Authorization. It exposes 4 tools, including get_repo_stats, search_repos and get_repo_languages. It scores C (40/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install github-mcp-server in Claude Code

1. Add the server

```bash
claude mcp add --transport http github-mcp-server https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/github-mcp-server/mcp --header 'Authorization: Bearer <YOUR_TOKEN>'
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Verify it's connected

```bash
claude mcp list
```

4. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

5. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. get_repo_stats, search_repos, get_repo_languages). It discovers them automatically.

### How to install github-mcp-server in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "github-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/github-mcp-server/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

4. Why the wrapper?

   This is a remote (HTTP) server and Claude Desktop only launches local processes, so mcp-remote proxies the connection. It will open a browser window if the server needs OAuth.

5. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install github-mcp-server in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "github-mcp-server": {
      "url": "https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/github-mcp-server/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install github-mcp-server in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.github-mcp-server]
command = "npx"
args = ["-y", "mcp-remote", "https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/github-mcp-server/mcp", "--header", "Authorization:${AUTH_HEADER}"]
env = { AUTH_HEADER = "Bearer <YOUR_TOKEN>" }
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Why the wrapper?

   Codex runs MCP servers as local processes, so mcp-remote bridges this HTTP endpoint to stdio.

4. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install github-mcp-server in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "github-mcp-server": {
      "serverUrl": "https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/github-mcp-server/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install github-mcp-server in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "github-mcp-server": {
      "type": "streamableHttp",
      "url": "https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/github-mcp-server/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

3. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

### How to install github-mcp-server in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "github-mcp-server": {
      "type": "http",
      "url": "https://nexgendata-mcp-proxy.steve-corbeil.workers.dev/github-mcp-server/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}
```

2. Fill in your credentials

   Replace Bearer <YOUR_TOKEN> with your real value. Keep secrets out of any config file you commit.

3. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `get_repo_stats` — Fetch comprehensive statistics for a specific GitHub repository. Returns total stars, forks, issues (open/closed), pull requests, watchers, last commit date, and contributor count. Returns metrics useful for assessing project popularity and maintenance status.
- `search_repos` — Search across GitHub for repositories matching keywords, sorted by relevance or metrics. Returns matching repositories with description, star count, language, and last update timestamp. Use for finding projects, libraries, or code samples related to specific topics.
- `get_repo_languages` — Analyze the programming language composition of a GitHub repository. Returns percentage breakdown of languages used, dominant language, and file counts per language. Use for understanding project tech stack or evaluating language distribution.
- `compare_repos` — Compare multiple GitHub repositories side-by-side with key metrics. Returns star counts, fork counts, issues, primary language, and comparative analysis for each repository. Use for choosing between similar projects or analyzing competitive landscape.

---

Source: https://mcp-skills-hub.vercel.app/mcps/com-thenextgennexus-github-mcp-server · MCP Skills Hub · data as of 2026-10-28T12:31:05Z
