# Install mcp-inspector with Homebrew, MacPorts

Visual testing tool for MCP servers. Version 0.22.0 via Homebrew; verified 2026-06-05.

## Install

```sh
sudo av install brew:mcp-inspector
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mcp-inspector
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install mcp-inspector
```

  Evidence: MacPorts ports tree: llm/mcp-inspector/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:mcp-inspector
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/mcp-inspector>
- **Version:** 0.22.0
- **Source summary:** Visual testing tool for MCP servers
- **Homepage:** <https://modelcontextprotocol.io/docs/tools/inspector>
- **Repository:** <https://github.com/modelcontextprotocol/inspector>
- **Upstream docs:** <https://github.com/modelcontextprotocol/inspector#readme>
- **License:** MIT
- **Source archive:** <https://registry.npmjs.org/@modelcontextprotocol/inspector/-/inspector-0.22.0.tgz>
- **Last updated:** 2026-06-05T17:14:41Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- mcp-inspector (cli)
- mcp-inspector (alias)

## Dependencies

- node

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.22.0
- Package-manager updated: 2026-06-05
- Local data: ok
- Upstream repository: https://modelcontextprotocol.io/docs/tools/inspector
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

MCP Inspector is the official visual testing and debugging tool for Model Context Protocol servers. It packages a browser UI and a local proxy so developers can exercise MCP servers over stdio, SSE, or Streamable HTTP while inspecting tools, resources, prompts, and authentication behavior.

### Project history

The public repository was created under the modelcontextprotocol GitHub organization in October 2024, shortly before MCP tooling became a common dependency of AI-editor and desktop-agent workflows. Its README describes a two-part architecture: a React-based MCP Inspector Client and a Node.js MCP Proxy that bridges the browser UI to MCP servers.

The official MCP documentation treats the Inspector as a developer tool and links it from the developer-tools section of the docs site. Later README updates added explicit proxy authentication and security guidance after the project became a common way to run local MCP processes from a browser-driven workflow.

### Adoption history

The Inspector is distributed primarily as an npm-executed tool, with the README documenting `npx @modelcontextprotocol/inspector` as the quick-start path and a container image as an alternative. Homebrew packaging gives macOS and Linux package-manager users a pinned `mcp-inspector` executable for the same official tool.

GitHub repository metadata showed more than ten thousand stars and more than a thousand forks by July 2026, which is unusually high for a protocol-specific debugging utility and reflects its role as the default manual test harness for MCP server authors.

### How it is used

Typical use is to launch the Inspector with no arguments for UI mode, or to pass an MCP server command such as `node build/index.js` so the tool can start the server and connect through its proxy. The README documents default local ports 6274 for the client UI and 6277 for the proxy server.

The Inspector can export server entries or complete MCP server files for use in clients such as Cursor, Claude Code, or the Inspector CLI. Its docs also warn that the proxy can spawn local processes and should not be exposed to untrusted networks.

### Why package nerds care

For package users, MCP Inspector is the rough equivalent of a protocol REPL plus GUI debugger: it lets a packaged MCP server be smoke-tested without building a bespoke client. That made it a natural Homebrew formula despite the upstream Node-centric install path.

Its significance is also operational. Because MCP servers often ship as tiny CLI packages launched by larger clients, a standalone inspector gives maintainers a reproducible way to debug transport, environment-variable, and authentication issues outside any one host application.

### Timeline

- 2024: GitHub repository created under modelcontextprotocol/inspector.
- 2025: Inspector documented as the official MCP visual testing and debugging tool.
- 2025: Proxy authentication and security guidance documented in the README.
- 2026: Repository metadata showed broad adoption with thousands of stars and forks.

### Related projects

- modelcontextprotocol/registry provides the official MCP server registry and publisher CLI.
- sparfenyuk/mcp-proxy and geelen/mcp-remote solve adjacent MCP transport-bridging problems.
- MCP SDKs and example servers provide the protocol implementations commonly tested with the Inspector.

### Sources

- <https://api.github.com/repos/modelcontextprotocol/inspector>
- <https://github.com/modelcontextprotocol/inspector>
- <https://github.com/modelcontextprotocol/inspector#readme>
- <https://modelcontextprotocol.io/docs/tools/inspector>
- source_facts.description
- source_facts.package-manager-url


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** mcp-inspector
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- MacPorts - mcp-inspector: normalized package name match | MacPorts ports tree: llm/mcp-inspector/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [MCP tool packages](https://www.automicvault.com/pkg/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew.
- [chrome-devtools-mcp](https://www.automicvault.com/pkg/brew/chrome-devtools-mcp/) - Shares av.db curated category or tags: cli, debugging, developer-tools, mcp.
- [klee](https://www.automicvault.com/pkg/brew/klee/) - Shares av.db curated category or tags: cli, developer-tool, developer-tools, testing.
- [airtable-mcp-server](https://www.automicvault.com/pkg/brew/airtable-mcp-server/) - Shares av.db curated category or tags: cli, developer-tools, mcp.
- [allure](https://www.automicvault.com/pkg/brew/allure/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [artillery](https://www.automicvault.com/pkg/brew/artillery/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [busted](https://www.automicvault.com/pkg/brew/busted/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [bzt](https://www.automicvault.com/pkg/brew/bzt/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [cargo-fuzz](https://www.automicvault.com/pkg/brew/cargo-fuzz/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [mcp-get](https://www.automicvault.com/pkg/brew/mcp-get/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, mcp, node.
- [mcp-remote](https://www.automicvault.com/pkg/brew/mcp-remote/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, mcp, node.

## Combined YAML source

View the package source record on GitHub. [combined/mcp-inspector.yml](https://github.com/automic-vault/db/blob/main/combined/mcp-inspector.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
