Homebrew Package Management on macOS의 모델 콘텍스 프로토콜(MCP) 서버는 Claude Desktop 및 기타 MCP 호환 클라이언트와 완벽하게 통합하도록 설계되었습니다.

• ** 언어:** Python 3.13
• MCP: 모형 Context 의정서
• 패키지 매니저: 홈brew (macOS)
• **Venv/Dependency Manager: ** uv

---

특징

• MCP 도구로 Homebrew 명령을 노출합니다. 지원된 명령은 함수에 의해 그룹화됩니다:
• 패키지 관리: install, uninstall, upgrade, cleanup]
• 정보 및 발견: list, search, info], outdated], deps]
• 시스템 헬스 & 업데이트: doctor, update
• 탭 및 소스 관리: tap, untap] -버전 관리: pin, unpin]
• 서비스 관리: services
• 실제 실행 brew 하위 프로세스를 통해 명령 (MacOS에서 Homebrew 필요).
• 완전 MCP spec-compliant (스트디오, JSON-RPC 2.0, MCP spec 2025-06-18).
• Claude 데스크톱 및 기타 LLM 클라이언트에 대한 설계.
• Functional, declarative Python (클래스 없음).
• homebrew_mcp.log에 대한 모든 요청/results를 기록합니다.
• 대화 형 테스트 스크립트 포함 (test_claude_homebrew_mcp.py) 그:
• MCP 서버에서 Dynamically fetches 사용 가능한 도구.

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.