Homebrew MCP Server

Homebrew MCP Python服务器

用于Homebrew包管理的模型上下文协议（MCP）服务器 在 macOS 上，专为与Claude Desktop和其他MCP兼容客户端无缝集成而设计。

• 语言： Python 3.13
• MCP： 模型上下文协议
• 包管理器： 自制（macOS）
• Venv/依赖管理器： 紫外线

______________________________________________________________________

特性

• 将Homebrew命令作为MCP工具公开。支持的命令按功能分组：

- 包管理： install, uninstall, upgrade, cleanup - 信息与发现： list, search, info, outdated, deps - 系统运行状况和更新： doctor, update - 点击源代码管理（&S）： tap, untap - 版本管理： pin, unpin - 服务管理： services

• 运行真实 brew 通过子进程执行命令（需要macOS上的Homebrew）。
• 完全符合MCP规范（stdio、JSON-RPC 2.0、MCP规范2025-06-18）。
• 专为Claude Desktop和其他LLM客户设计。
• 函数式、声明式Python（无类）。
• 将所有请求/结果记录到 homebrew_mcp.log.
• 包含交互式测试脚本(test_claude_homebrew_mcp.py)即：

- 从MCP服务器动态获取可用工具。 - 允许Claude对单个用户提示进行多个工具调用。 - 演示与Anthropic API的高级交互模式。

______________________________________________________________________

安装

1. 克隆此存储库：

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

1. 安装 紫外线 （如果还没有）：

   brew install uv

1. 创建虚拟环境并安装依赖项：

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

1. 运行MCP服务器（用于本地测试）：

要在本地或开发期间测试服务器，可以直接运行它：

   uv run python homebrew_mcp.py

然后，服务器将启动。如果成功，将不会立即输出；它将通过stdio静默地监听MCP请求。您可以通过检查来确认它正在运行 homebrew_mcp.log 文件。

> 注： 如果您正在与Claude Desktop集成 不 需要手动运行此命令。Claude Desktop将根据“Claude Desktop Integration”部分中提供的配置自动启动服务器。此命令用于直接测试或开发目的。

______________________________________________________________________

光标集成

先决条件： 在添加工具之前，请完成 安装 部分设置项目及其依赖关系。“添加到光标”按钮假定项目位于 ~/Documents/GitHub/homebrew-mcp.

1. 通过Homebrew（macOS）安装Cursor：

   brew install --cask cursor

1. 将工具添加到光标:

- 单击上面的“添加到光标”按钮。这将打开Cursor并自动安装该工具。 - 如果您的项目不在按钮假定的位置，则需要编辑生成的配置。在macOS上，此文件位于 ~/.cursor/mcp.json.打开它并更新内部的路径 command 字符串为 homebrew-mcp 进入。这 mcp.json 此存储库中的文件可以用作参考。

1. 重新启动游标:

- 要使该工具处于活动状态，请在安装后重新启动Cursor。

______________________________________________________________________

Claude桌面集成

1. 通过Homebrew（macOS）安装Claude Desktop：

   brew install --cask claude

1. 确保 uv 在您的PATH中，项目是可访问的。

1. 配置Claude Desktop以使用此MCP服务器：

- 在macOS上，在以下位置编辑或创建用户级MCP配置文件： ~/Library/Application Support/Claude/claude_desktop.json. - 添加以下服务器定义，替换 /path/to/your/project/ 随着 绝对路径 转到克隆此项目的目录。您可以参考 claude_desktop_config.json 以这个存储库中的文件为例。

{
  "mcpServers": {
    "homebrew-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/your/project/",
        "homebrew_mcp.py"
      ],
      "type": "stdio"
    }
  }
}

*这 --directory 告诉 uv 在哪里可以找到 homebrew_mcp.py 脚本及其上下文（如 .venv).*

1. 重新启动克劳德桌面。

______________________________________________________________________

项目结构

• Python脚本

- homebrew_mcp.py --主MCP服务器脚本。 - test_claude_homebrew_mcp.py --交互式Claude集成测试脚本。

• 配置

- claude_desktop_config.json --Claude Desktop的示例配置。 - mcp.json --Cursor的配置示例。 - requirements.txt --Python项目依赖关系。

• 文档和元数据

- README.md --这个文件。 - LICENSE --该项目的麻省理工学院许可证。 - .gitignore --指定Git要忽略的文件。

• 生成的文件（不在Git中）

- .venv/ --由管理的Python虚拟环境 uv. - homebrew_mcp.log --MCP服务器的日志文件。

______________________________________________________________________

监控日志

要实时查看服务器日志并漂亮地打印每一行JSON：

tail -f homebrew_mcp.log | jq .

______________________________________________________________________

测试环境

此MCP服务器及其与Claude的集成已在以下环境中进行了初步测试：

• macOS： 索诺玛14.7.5
• 自制： 4.5.8
• python 3.13（通过管理 uv)

- mcp模块： 1.9.4（使用 uv pip)

• 人择模块： 0.55.0（使用安装 uv pip)
• 克劳德桌面： 0.10.38（在macOS上通过Homebrew Cask安装）。
• 光标： 1.1.4

______________________________________________________________________

示例提示

以下是与此Homebrew MCP服务器交互时，您可以与Claude（或其他MCP客户端）一起使用的一些示例提示：

• 提供所有已安装软件包的摘要
• 检查安装了哪些软件包，并为其他软件包的安装提供建议
• 我的自制程序设置有问题吗？我该如何修复它们？
• 显示有关python 3.13包的信息
• 安装wget软件包

______________________________________________________________________

交互式Claude测试脚本

运行Claude集成测试(test_claude_homebrew_mcp.py)，您需要一个Anthropic Claude API密钥。在中设置API密钥 ANTHROPIC_API_KEY 测试脚本顶部的变量。此脚本允许您与Claude交互，Claude反过来使用 homebrew_mcp.py 服务器。它展示了动态工具发现和Claude进行多个工具调用的能力。

uv run python test_claude_homebrew_mcp.py

______________________________________________________________________

测试运行输出示例

本节显示了运行 test_claude_homebrew_mcp.py 脚本。 它演示了Claude和Homebrew MCP服务器之间的交互，包括动态工具发现、多个工具调用和最终响应。

$ uv run python test_claude_homebrew_mcp.py

============================== Claude Prompt 1/7 ===============================
install wget if not installed, or uninstall if already installed
================================================================================
============================= Claude's Answer 1/7 ==============================
I've successfully installed wget on your system. Now that wget is installed, if you'd like me to uninstall it instead (as per your request to either install if not present or uninstall if already installed), I can do that for you.

Would you like me to proceed with uninstalling wget now? Please let me know.
================================================================================

============================== Claude Prompt 2/7 ===============================
restore initial state of wget
================================================================================
============================= Claude's Answer 2/7 ==============================
I've successfully uninstalled wget, returning your system to its initial state before our conversation. The wget package has been completely removed from your system.
================================================================================

============================== Claude Prompt 3/7 ===============================
check for outdated packages
================================================================================
============================= Claude's Answer 3/7 ==============================
You have 3 outdated packages:
1. libnghttp2
2. uv
3. yt-dlp

These packages have newer versions available and can be upgraded if you wish.
================================================================================

============================== Claude Prompt 4/7 ===============================
provide a summary of all installed packages
================================================================================
============================= Claude's Answer 4/7 ==============================
Here's a summary of all installed packages on your system:

1. **Command Line Tools & Utilities**: bash, coreutils, curl, git, jq, nmap, grep, watch, etc.
2. **Programming Languages & Tools**: python (multiple versions), node, go, lua
3. **Media Tools & Libraries**: ffmpeg and its dependencies (x264, x265, etc.), yt-dlp
4. **Development Tools**: neovim, tree-sitter, shellcheck
5. **Applications (Casks)**:
   - Browsers: google-chrome, firefox
   - Development: visual-studio-code, iterm2, cursor, github
   - Communication: discord, whatsapp
   - Media: vlc, spotify, stremio
   - Utilities: docker-desktop, keepassxc, alt-tab, disk-inventory-x
   - AI/ML tools: chatgpt, claude, ollama, s```