SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台homebrew-mcp

homebrew-mcp

Homebrew MCP 是一个基于 Model Context Protocol（MCP）的 Python 服务器，用于在 macOS 上通过自然语言管理 Homebrew 包。它把 brew 命令封装为 MCP 工具，支持安装、卸载、升级、清理、搜索、查看信息、检查过时包、依赖查询、系统健康检查、更新、tap/untap、pin/unpin 以及服务管理等操作。该服务器通过 subprocess 执行真实的 brew 命令，兼容 MCP 规范（stdio、JSON-RPC 2.0、MCP spec 2025-06-18），专为 Claude Desktop 及其他 MCP 兼容客户端设计。项目使用 Python 3.13 和 uv 管理依赖，所有请求与结果记录到 homebrew_mcp.log，并附带交互式测试脚本，可动态获取可用工具并允许 Claude 对单个用户提示进行多次工具调用。

访问官网

工具介绍

Homebrew MCP 是一个面向 macOS 的 Model Context Protocol（MCP）服务器，旨在让用户通过自然语言与 Homebrew 包管理器交互。它把 Homebrew 命令暴露为 MCP 工具，使 Claude Desktop 等 MCP 兼容客户端能够直接调用 brew 功能，完成包管理、信息查询和系统维护等任务。

主要能力按功能分组：

  • 包管理：install、uninstall、upgrade、cleanup
  • 信息与发现：list、search、info、outdated、deps
  • 系统健康与更新：doctor、update
  • Tap 与源管理：tap、untap
  • 版本管理：pin、unpin
  • 服务管理：services

该服务器通过 subprocess 运行真实的 brew 命令，因此需要在 macOS 上安装 Homebrew。它完全符合 MCP 规范（stdio、JSON-RPC 2.0、MCP spec 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
  2. 安装 uv（如未安装）：brew install uv
  3. 创建虚拟环境并安装依赖：uv venv；source .venv/bin/activate；uv pip install -r requirements.txt
  4. 本地测试运行 MCP 服务器：uv run python homebrew_mcp.py。服务器启动后不会立即输出，而是静默监听 stdio 上的 MCP 请求，可通过 homebrew_mcp.log 确认运行状态。若与 Claude Desktop 集成，无需手动运行此命令，Claude Desktop 会根据配置自动启动服务器。

Cursor 集成：

  • 前置条件：先完成安装部分的步骤，设置项目及依赖。“Add to Cursor”按钮假定项目位于 ~/Documents/GitHub/homebrew-mcp。
  • 通过 Homebrew 安装 Cursor：brew install --cask cursor
  • 点击“Add to Cursor”按钮，Cursor 会打开并自动安装工具。若项目不在假定位置，需编辑生成的配置。在 macOS 上，该文件位于 ~/.cursor/mcp.json，打开并更新 homebrew-mcp 条目中命令字符串内的路径。仓库中的 mcp.json 可作为参考。
  • 安装后重启 Cursor 使工具生效。

Claude Desktop 集成：

  • 通过 Homebrew 安装 Claude Desktop：brew install --cask claude
  • 确保 uv 在 PATH 中且项目可访问。
  • 配置 Claude Desktop 使用此 MCP 服务器：在 macOS 上编辑或创建用户级 MCP 配置文件 ~/Library/Application Support/Claude/claude_desktop.json，添加服务器定义，将 /path/to/your/project/ 替换为克隆项目的绝对路径。可参考仓库中的 claude_desktop_config.json 示例。--directory 参数告诉 uv 在哪里找到 homebrew_mcp.py 脚本及其上下文（如 .venv）。
  • 重启 Claude Desktop。

项目结构：

  • 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（MIT 许可证）、.gitignore
  • 生成文件（不在 Git 中）：.venv/（由 uv 管理的 Python 虚拟环境）、homebrew_mcp.log（MCP 服务器日志文件）

监控日志：可实时查看服务器日志并美化打印每行 JSON。

测试环境：该 MCP 服务器及其与 Claude 的集成主要在以下环境测试：macOS Sonoma 14.7.5、Homebrew 4.5.8、Python 3.13（通过 uv 管理）、mcp 模块 1.9.4（使用 uv pip 安装）、anthropic 模块 0.55.0（使用 uv pip 安装）、Claude Desktop 0.10.38（通过 Homebrew Cask 在 macOS 上安装）。

示例提示词：

  • 提供所有已安装包的摘要
  • 检查已安装的包，并建议其他可安装的包
  • 我的 Homebrew 设置有什么问题？如何修复？
  • 显示 python 3.13 包的信息
  • 安装 wget 包

交互式 Claude 测试脚本：运行 test_claude_homebrew_mcp.py 需要 Anthropic Claude API 密钥，在脚本顶部的 ANTHROPIC_API_KEY 变量中设置。该脚本允许你与 Claude 交互，Claude 进而使用 homebrew_mcp.py 服务器，演示动态工具发现和 Claude 进行多次工具调用的能力。

限制：该工具仅适用于 macOS，且需要预先安装 Homebrew。使用 Claude 集成测试脚本需要 Anthropic API 密钥。其他平台或未安装 Homebrew 的环境暂不支持。

同类工具

查看分类