Homebrew MCP Python Server
A Model Context Protocol (MCP) server for Homebrew package management on macOS, designed for seamless integration with Claude Desktop and other MCP-compatible clients.
- Language: Python 3.13
- MCP: Model Context Protocol
- Package Manager: Homebrew (macOS)
- Venv/Dependency Manager: uv
Features
- Exposes Homebrew commands as MCP tools. The supported commands are grouped by function:
- Package Management:
install,uninstall,upgrade,cleanup - Information & Discovery:
list,search,info,outdated,deps - System Health & Updates:
doctor,update - Tap & Source Management:
tap,untap - Version Management:
pin,unpin - Service Management:
services
- Package Management:
- Runs real
brewcommands via subprocess (requires Homebrew on macOS). - Fully MCP spec-compliant (stdio, JSON-RPC 2.0, MCP spec 2025-06-18).
- Designed for Claude Desktop and other LLM clients.
- Functional, declarative Python (no classes).
- Logs all requests/results to
homebrew_mcp.log. - Includes an interactive test script (
test_claude_homebrew_mcp.py) that:- Dynamically fetches available tools from the MCP server.
- Allows Claude to make multiple tool calls for a single user prompt.
- Demonstrates advanced interaction patterns with the Anthropic API.
