mcp-gh

A simple, read-only MCP for gathering information from public GitHub repositories.

Installation and usage

You can run the server locally with npx (no install):

npx -y mcp-gh --transport stdio

Or start an HTTP server:

npx -y mcp-gh --transport http --port 3000

Environment variables (optional):

• GITHUB_TOKEN: Increases GitHub API rate limits
• LOG_LEVEL: debug | info | warn | error (default: info)
• PORT: HTTP port (default: 3000)

Configure in mcp.json

Add to your ~/.cursor/mcp.json (or app-specific MCP config) to run via npx:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "mcp-gh", "--transport", "stdio"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}" 
      }
    }
  }
}

To run via HTTP instead:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "mcp-gh", "--transport", "http", "--port", "3000"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

CLI options

• --transport <stdio|http> (default: stdio)
• --port <number> (HTTP only, default: 3000)
• --mode <production|development> (default: production)
• --include-ping Include ping tool in non-dev mode
• --log-level <debug|info|warn|error>
• --help Show help