Сервер Model Context Protocol (MCP) для управления пакетами Homebrew ** на macOS**, предназначенный для бесшовной интеграции с Claude Desktop и другими MCP-совместимыми клиентами.

Язык: Python 3.13 **MCP: ** Модель контекстного протокола Менеджер пакетов: Homebrew (macOS) Venv/Dependency Manager:

Особенности

• Выставляет команды Homebrew в качестве инструментов MCP. Поддерживаемые команды группируются по функциям: **Управление пакетами: ** install, uninstall, upgrade, cleanup **Информация и открытие: ** list, search, info, outdated, deps **Система здоровья и обновления: ** doctor, update ** Нажмите и Управление Источником: ** tap, untap
• ** Управление версиями: ** pin, unpin **Управление услугами: ** services Запускает реальные команды brew через подпроцесс (требует Homebrew на macOS). Полностью MCP spec-compliant (stdio, JSON-RPC 2.0, MCP spec 2025-06-18). Предназначен для Claude Desktop и других клиентов LLM. Функциональный, декларативный Python (без классов).
• регистрирует все запросы/результаты homebrew_mcp.log.
• Включает интерактивный тестовый сценарий ([T18]), который: Динамично извлекает доступные инструменты с сервера MCP.

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
• 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.

---

Installation

1. Clone this repository:

   git clone https://github.com/jeannier/homebrew-mcp
   cd homebrew-mcp
   

2. Install uv (if not already):

   brew install uv
   

3. Create a virtual environment and install dependencies:

   uv venv
   source .venv/bin/activate  # Activate the virtual environment
   uv pip install -r requirements.txt
   

4. Run the MCP Server (for Local Testing): To test the server locally or during development, you can run it directly:

   uv run python homebrew_mcp.py
   

   The server will then start. If successful, there will be no immediate output; it will silently listen for MCP requests over stdio. You can confirm it’s running by checking the homebrew_mcp.log file.

   Note: If you are integrating with Claude Desktop, you do not need to run this command manually. Claude Desktop will start the server automatically based on the configuration provided in the “Claude Desktop Integration” section. This command is for direct testing or development purposes.

---

Cursor Integration

Prerequisite: Before adding the tool, please complete the steps in the Installation section to set up the project and its dependencies. The “Add to Cursor” button assumes the project is located at ~/Documents/GitHub/homebrew-mcp.