github-mcp

GitHub v3 REST API MCP (Model Context Protocol) server, generated by mcpify.

Exposes exactly 3 tools — search, get, call — backed by an embedded semantic database (mcp_store.db), so an LLM never needs the full API surface in context.

Install

cargo build --release

Setup

cargo run -- setup

Interactively collects the API URL and the credentials your chosen auth method needs, then lets you persist them as a .env file, a config.json file, or a ready-to-run CLI invocation.

Usage

Terminal Client (default)

github-mcp search "create an issue"
github-mcp get <operationId>
github-mcp call <operationId> --some-arg value

Harness Server

github-mcp start                              # stdio transport (default)
github-mcp http --host 127.0.0.1 --port 3000  # HTTP transport

Testing

cargo test

Coverage

bash scripts/coverage.sh   # writes target/coverage/html/index.html (requires cargo-llvm-cov)

Profiling

bash scripts/profile.sh   # CPU profiling via samply, writes profile/bottleneck-report.md
cargo run --release --features profiling -- search "test query"   # heap profiling via dhat-rs, writes dhat-heap.json

profile/bottleneck-report.md combines coverage gaps with the hottest CPU functions in one small text file — paste it into an LLM (or hand it to another tool) to find and fix bottlenecks. Requires samply (cargo install samply).

Generated by mcpify — do not hand-edit generated files; re-run mcpify against an updated OpenAPI spec instead.

github-mcp 0.1.2