`gitctx` is an MCP server that gives agents and IDE assistants targeted, up-to-date access to GitHub repositories. Code, Issues, PRs, Commits, Releases, everything. This is an open-source alternative to Amp's [Librarian](https://ampcode.com/news/librarian) and was inspired by the same.


Why gitctx

• Focused GitHub exploration primitives instead of generic web scraping
• Stateful repository context across tool calls (repo, branch, path)
• Good defaults for iterative code understanding workflows
• Works with any MCP client that supports stdio transport

Feature Summary

• Repository discovery and selection (find_repo)
• Codebase navigation: tree/list/read/search/switch branch
• Issue and PR exploration with filters and metadata
• Commit, blame, and release analysis
• Repository statistics and dependency graph lookups
• MCP resource exposing current selected context
• In-memory API caching to reduce repeated calls

Table of Contents

• Installation
• Quick Start
• Coding Agents Setup
• MCP Client Configuration
• Tool Catalog
• Resources
• Authentication and Permissions
• Operational Notes
• Use Cases
• FAQ / Troubleshooting
• Development
• Project Structure
• Inspiration
• License

Installation

From source

git clone https://github.com/winfunc/gitctx.git
cd gitctx
cargo build --release
./target/release/gitctx-mcp

Cargo

cargo install gitctx
gitctx-mcp

Quick Start

1. Set a GitHub token (recommended