hackerdogs/github-mcp repository overview

⁠

⁠Github MCP Server

MCP server wrapper for GitHub MCP⁠ — interact with GitHub repositories, issues, pull requests, and code search via the GitHub Copilot API. See github/github-mcp-server⁠ for full documentation.

⁠What is GitHub MCP?

GitHub MCP exposes the GitHub API as MCP tools, letting AI assistants read and create issues, comment on pull requests, search code, browse repository trees, and perform other GitHub operations on your behalf. In production the Hackerdogs integration connects to the hosted endpoint at https://api.githubcopilot.com/mcp/ using your GitHub token. This Docker image is a local compliance stub that satisfies MCP server shape requirements for CI and offline use.

GitHub token required for production use — configure a Personal Access Token or GitHub App token with the appropriate repository scopes.

⁠Tools Reference

⁠Tools Reference

⁠Example Prompts

Here are example prompts you can use with Claude (or any MCP client) when this tool is connected:

• "List all open issues in the repo owner/repo that are labeled 'bug'."
• "Create a new issue in owner/repo titled 'Login page crashes on Safari' with steps to reproduce."
• "Search the codebase in owner/repo for all usages of the deprecated function legacy_auth()."
• "Show me the last 10 commits on the main branch of owner/repo."
• "Add a comment on pull request #42 in owner/repo asking for tests to be added."
• "List all open pull requests in owner/repo and summarize the changes in each."

⁠Deploy

⁠Docker Compose (recommended)

docker-compose up -d

⁠Docker Run (stdio mode)

docker run -i --rm hackerdogs/github-mcp:latest

⁠Docker Run (HTTP streamable mode)

docker run -d -p 8521:8521 \
  -e MCP_TRANSPORT=streamable-http \
  -e MCP_PORT=8521 \
  hackerdogs/github-mcp:latest

⁠MCP Client Configuration

⁠Stdio mode (default)

Add to your Claude Desktop or Cursor MCP config:

{
  "mcpServers": {
    "github-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT", "hackerdogs/github-mcp:latest"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

⁠HTTP mode (streamable-http)

First, start the server using Docker Compose or docker run with HTTP mode (see Deploy⁠ above), then point your MCP client at the running server:

{
  "mcpServers": {
    "github-mcp": {
      "url": "http://localhost:8521/mcp"
    }
  }
}

⁠Environment Variables

⁠Installing in Hackerdogs

The fastest way to get started is through Hackerdogs⁠:

1. Log in to your Hackerdogs account.
2. Go to the Tools Catalog.
3. Search for the tool by name (e.g. "nuclei", "naabu", "julius").
4. Expand the tool card and click Install — you're ready to go.

1. Vendor API key required? Add your key in the config environment variable field before clicking Install. Your key will be encrypted at rest.
2. Enable / Disable the tool anytime from the Enabled Tools page.
3. Need to update a key or parameter? Go to My Tools → toggle Show Decrypted Values → edit → Save.

⁠Build

docker build -t hackerdogs/github-mcp:latest .

⁠Testing

⁠Automated tests

./test.sh

⁠Test directly with Docker

1. Start the server in HTTP mode:

docker run -d --rm --name github-mcp-test -p 8521:8521 \
  -e MCP_TRANSPORT=streamable-http \
  hackerdogs/github-mcp:latest

2. Initialize the MCP session:

SESSION_ID=$(curl -s -D - -X POST http://localhost:8521/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' \
  2>&1 | grep -i mcp-session-id | awk '{print $2}' | tr -d '\r\n')

curl -s -X POST http://localhost:8521/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

3. Call a tool:

curl -s -X POST http://localhost:8521/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: $SESSION_ID" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"run_github","arguments":{"arguments":"--help"}}}'

4. Clean up:

docker stop github-mcp-test

⁠Running the tool directly (bypassing MCP)

You can run the Github CLI in the same container by overriding the entrypoint without starting the MCP server.

Show help:

docker run -i --rm --entrypoint github hackerdogs/github-mcp:latest --help