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

80 lines
1.6 KiB
Markdown

---
last_review_date: "2025-07-18"
---
# Homebrew's MCP Server
Homebrew's MCP Server is the official MCP ([Model Context Protocol](https://modelcontextprotocol.io/)) 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.
```bash
$ brew mcp-server
==> Started Homebrew MCP server...
```
Press Ctrl-D or Ctrl-C to terminate it.
## Configuration
### Example configuration for [Cursor](https://www.cursor.com/)
```json
{
"mcpServers": {
"Homebrew": {
"command": "brew mcp-server"
}
}
}
```
### Example configuration for [VSCode](https://code.visualstudio.com/)
```json
{
"mcp": {
"servers": {
"Homebrew": {
"type": "stdio",
"command": "brew",
"args": ["mcp-server"]
}
}
}
}
```
### Example configuration for [Zed](https://github.com/zed-industries/zed)
```json
{
"context_servers": {
"Homebrew": {
"command": {
"path": "brew",
"args": ["mcp-server"]
}
}
}
}
```
### Example configuration for [Claude Desktop](https://claude.ai/download)
```json
{
"mcpServers": {
"Homebrew": {
"command": "brew mcp-server"
}
}
}
```