Homebrewパッケージ管理用のモデルコンテキストプロトコル(MCP)サーバーon macOSは、Claude Desktopや他のMCP互換クライアントとのシームレスな統合のために設計されています。

• 言語: Python 3.13
• MCP: モデル コンテキスト プロトコル
• パッケージマネージャ: Homebrew (macOS)
• Venv/Dependency Manager: uv

お問い合わせ

##特徴

• MCPツールとしてHomebrewコマンドを公開します。 サポートされているコマンドは、関数によってグループ化されます。
• パッケージ管理: install, uninstall], [upgrade], [cleanup]] search, info, [outdated]], [[deps]]
• システムヘルス&アップデート: doctor, [update
• タップ&ソース管理: tap, [untap
• バージョン管理: pin, [unpin]
• サービス管理: services
• サブプロセス(macOS上でHomebrewを要求する)を介して実際の[[brewコマンドを実行します。
• 十分にMCPのspec-compliant (stdio、JSON-RPC 2.0、MCPの指定2025-06-18)。
• Claudeデスクトップや他のLMクライアントのために設計されています。
• 機能的、宣言的なPython(クラスなし)。
• [homebrew_mcp.logにすべてのリクエスト/結果を記録します。
• インタラクティブなテストスクリプト([test_claude_homebrew_mcp.py])を含む:
• 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.