Skip to content

andreagrandi/mcp-wire

Repository files navigation

mcp-wire

mcp-wire logo

mcp-wire is a Go CLI that installs and configures MCP (Model Context Protocol) servers across multiple AI coding tools from one interface.

How It Works

No manual config editing needed. Run mcp-wire to open a full-screen TUI with guided install and uninstall wizards.

Choose a source

Pick from bundled curated services or the community MCP registry:

mcp-wire — Install

Install › Source

  Where should mcp-wire look for services?

  › Curated services       recommended, maintained by mcp-wire
    Registry services      community-published MCP servers
    Both                   curated + registry combined

↑↓ move  Enter select  Esc back

Search and select a service

Live-filtered search across hundreds of registry entries:

mcp-wire — Install

Install › community ✓ › Service › Targets › Review › Apply

  Search: sentry                                     2 matches

  › ai.sentry/sentry-mcp
    Sentry error tracking and performance monitoring MCP server

    ai.example/sentry-alerts
    Forward Sentry alerts to your AI coding assistant

                          — end of results —

↑↓ move  Enter select  type to filter  Esc back

Review before installing

Registry services show metadata and require explicit confirmation:

mcp-wire — Install

Install › community ✓ › Service › Targets › Review › Apply

  △ Registry Service — not curated by mcp-wire

  ai.sentry/sentry-mcp
  Sentry error tracking and performance monitoring MCP server

  Source:    community registry
  Transport: http
  URL:       https://mcp.sentry.io/sse

  Registry services are community-published. Review before proceeding.

  › Yes, proceed     No, go back

←→ move  Enter confirm  Esc back

Explicit CLI mode

For scripting and CI, explicit commands work without the TUI:

mcp-wire install jira --target claude --no-prompt
mcp-wire uninstall sentry --target opencode

Scope-aware installs (Claude Code)

For targets that support scopes (currently Claude Code), you can choose where MCP config is written:

  • user (default): available across projects
  • project: only for the current project
mcp-wire install jira --target claude --scope user
mcp-wire install jira --target claude --scope project
mcp-wire uninstall jira --target claude --scope project

Supported Targets

  • claude - Claude Code
  • codex - Codex CLI
  • gemini - Gemini CLI
  • opencode - OpenCode

Supported Services

Bundled (curated)

These ship with the binary and work out of the box:

  • context7 - Context7 documentation lookup MCP (OAuth)
  • jira - Atlassian Rovo MCP server (OAuth)
  • sentry - Sentry MCP server (OAuth)
  • playwright - Playwright browser automation MCP (npx @playwright/mcp@latest)

MCP Registry (community)

mcp-wire can also install from the Official MCP Registry, giving access to hundreds of community-published MCP servers. Enable with:

mcp-wire feature enable registry

Once enabled, the install wizard offers a source selection step (Curated / Registry / Both) with live search across all registry entries.

Installation

Homebrew (macOS/Linux)

brew tap andreagrandi/tap
brew install mcp-wire

Build from source

git clone https://github.com/andreagrandi/mcp-wire
cd mcp-wire
make build
./bin/mcp-wire

Contributing

Contributions are welcome, especially new service definitions.

  • Add a new service via YAML: create a file in services/ (no Go code required).
  • Service schema: name, description, transport, and either url (for sse/http) or command/args (for stdio).
  • Transport values: http (streamable HTTP endpoint), sse (Server-Sent Events endpoint), stdio (local command-based MCP server).
  • OAuth services: add auth: oauth when applicable so install flows can drive authentication hints/automation.
  • Run checks before PRs: make test, make test-integration, make build.

Example service file:

name: example
description: "Example MCP"
transport: http
auth: oauth
url: "https://mcp.example.com/mcp"
env: []

Example stdio service:

name: example-stdio
description: "Example local MCP"
transport: stdio
command: npx
args: ["-y", "@example/mcp-server"]
env: []

About

CLI tool written in Go that lets users install and configure MCP (Model Context Protocol) servers across multiple AI coding CLI tools (Claude Code, Codex, OpenCode, etc.) from a single interface.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors