Advertise
MCP.so
Sign In

Homebrew MCP Python Server

@jeannier

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

jeannier

About Homebrew MCP Python Server

Homebrew MCP : Comprehensive brew support for installing, upgrading, searching, and maintaining macOS packages.

Homebrew MCP Python Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "homebrew-mcp": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Homebrew MCP Python Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Homebrew MCP Python Server?

A Model Context Protocol (MCP) server for Homebrew package management on macOS, designed for integration with Claude Desktop and other MCP-compatible clients. It exposes Homebrew commands as MCP tools for use by LLM clients.

How to use Homebrew MCP Python Server?

Install via cloning the repo, setting up a uv-managed Python virtual environment, and installing dependencies. For Claude Desktop, configure ~/Library/Application Support/Claude/claude_desktop.json with a uv run command pointing to the project. For Cursor, use the provided "Add to Cursor" button or manually edit ~/.cursor/mcp.json. The server runs via stdio and logs to homebrew_mcp.log.

Key features of Homebrew MCP Python Server

  • Exposes Homebrew commands as MCP tools (install, search, doctor, etc.)
  • Runs real brew commands via subprocess on macOS
  • Fully MCP spec-compliant (stdio, JSON-RPC 2.0)
  • Designed for Claude Desktop and other LLM clients
  • Functional, declarative Python (no classes)
  • Logs all requests/results to homebrew_mcp.log

Use cases of Homebrew MCP Python Server

  • Let Claude Desktop install, uninstall, or upgrade Homebrew packages
  • Ask an LLM to check Homebrew system health with brew doctor
  • Get a summary of installed packages or search for new ones
  • Automate package management tasks via chat interface
  • Test MCP tool interactions with the included test script

Frequently asked questions

1

What is Homebrew MCP Python Server and what does it do?

It is an MCP server that turns Homebrew commands (install, search, doctor, etc.) into tools that MCP client applications like Claude Desktop can call directly.

2

What are the dependencies/runtime requirements?

Requires macOS, Homebrew installed, Python 3.13, and the `uv` dependency manager. The MCP Python SDK and Anthropic SDK (for the test script) are installed via `requirements.txt`.

3

Where do logs and data live?

Logs are written to `homebrew_mcp.log` in the project directory. The server runs real `brew` commands, so package data resides in the normal Homebrew locations. The virtual environment is in `.venv`.

4

What transports and authentication does it use?

It uses stdio transport (MCP spec 2025-06-18) with JSON-RPC 2.0 messaging. No authentication is built-in; it relies on local machine access.

5

Can it be used with clients other than Claude Desktop?

Yes, it is designed for any MCP-compatible client. The README includes specific integration instructions for Cursor and demonstrates interaction with Claude via the Anthropic API test script.

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise