jeannier/homebrew-mcp

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

• 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
• Runs real brew commands 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.

1. 1.Clone this repository:

1. 1.Install uv (if not already):

1. 1.Create a virtual environment and install dependencies:

1. 1.*Run the MCP Server (for Local Testing):

Works with Claude (desktop and mobile), Cursor, Windsurf, VS Code, and any MCP-compatible AI app.

Category: Developer Tools