brew/docs/MCP-Server.md
Ivy Evans f4daecd3da docs: improve MCP server description
Removes tools table and expand on the first section with details about
what it can do.
2025-08-28 11:22:21 -07:00

1.6 KiB

last_review_date
last_review_date
2025-07-18

Homebrew's MCP Server

Homebrew's MCP Server is the official MCP (Model Context Protocol) server for Homebrew, enabling AI assistants like Cursor to interact with Homebrew directly, providing tools for package management, system diagnostics, and development workflows. It exposes common operations like package search/lookup, installation and removal, system updates, diagnostics, and development tools so AI assistants can help maintain your system and develop new formulas.

You don't need to do anything to install it. It's provided by default with Homebrew through the brew mcp-server command.

Usage

Run brew mcp-server to launch the Homebrew MCP Server.

$ brew mcp-server
==> Started Homebrew MCP server...

Press Ctrl-D or Ctrl-C to terminate it.

Configuration

Example configuration for Cursor

{
  "mcpServers": {
    "Homebrew": {
      "command": "brew mcp-server"
    }
  }
}

Example configuration for VSCode

{
  "mcp": {
    "servers": {
      "Homebrew": {
        "type": "stdio",
        "command": "brew",
        "args": ["mcp-server"]
      }
    }
  }
}

Example configuration for Zed

{
  "context_servers": {
    "Homebrew": {
      "command": {
        "path": "brew",
        "args": ["mcp-server"]
      }
    }
  }
}

Example configuration for Claude Desktop

{
  "mcpServers": {
    "Homebrew": {
      "command": "brew mcp-server"
    }
  }
}