Yellhorn MCP
by msnidal
Yellhorn MCP is a Model Context Protocol (MCP) server that exposes Gemini 2.5 Pro capabilities to Claude Code for software development tasks. It uses your entire codebase in the prompt to define work and review results, ensuring they meet specified requirements.
Last updated: N/A
What is Yellhorn MCP?
Yellhorn MCP is a server that provides a Model Context Protocol (MCP) interface, enabling AI coding agents like Claude Code to leverage the Gemini 2.5 Pro model with access to your entire codebase. It facilitates the creation of workplans, code review, and isolated development environments.
How to use Yellhorn MCP?
To use Yellhorn MCP, install it via pip or from source, configure environment variables (GEMINI_API_KEY, REPO_PATH, YELLHORN_MCP_MODEL), and integrate it with Claude Code using specific commands for creating workplans, worktrees, and reviewing code. You can run it as a standalone server or using the MCP CLI.
Key features of Yellhorn MCP
Create Workplans
Review Code Diffs
Isolated Development Environments
Seamless GitHub Integration
Context Control with .yellhornignore
MCP Resources for easy listing and retrieval
Use cases of Yellhorn MCP
Automated generation of detailed implementation plans based on prompts and codebase context.
Comprehensive code review ensuring adherence to original workplan requirements.
Streamlined, isolated development workflow with Git worktrees and linked branches.
Automated creation of labeled GitHub issues with proper branch linking and review sub-issues.
FAQ from Yellhorn MCP
What is the purpose of the GEMINI_API_KEY environment variable?
What is the purpose of the GEMINI_API_KEY environment variable?
It is your API key for accessing the Gemini model, which is required for Yellhorn MCP to function.
How do I exclude files from the AI context?
How do I exclude files from the AI context?
Use a .yellhornignore file, similar to .gitignore, to specify files and directories to exclude.
How do I install Yellhorn MCP?
How do I install Yellhorn MCP?
You can install it from PyPI using pip install yellhorn-mcp or from source by cloning the repository and running pip install -e ..
Can I use Yellhorn MCP with other coding agents besides Claude Code?
Can I use Yellhorn MCP with other coding agents besides Claude Code?
Yes, it is compatible with any coding agent that supports the Model Context Protocol (MCP).
How do I update to a new version of Yellhorn MCP?
How do I update to a new version of Yellhorn MCP?
If installed from PyPI, use pip install --upgrade yellhorn-mcp. If installed from source, pull the latest changes from the repository and reinstall using pip install -e ..