Skip to main content

mcp-hub

License: MIT Python 3.11+

A TUI package manager for MCP servers. It detects which AI coding agents are installed on your machine (Claude Code, Codex, Antigravity), shows what MCP servers each one already has connected, and lets you add or remove a server across every detected agent from one wizard — instead of hand-editing three different config files in three different formats.

Table of Contents

Features

  • Auto-detect — scans for Claude Code, Codex, and Antigravity config files on startup; no setup needed.
  • One dashboard — see every agent's MCP servers, and whether its config file even parses, in one table.
  • Add wizard — pick a server from the bundled catalog or enter one by hand, choose which detected agents to write it to, confirm.
  • Edit in place — update a server's command, args, or env (and rename it) without deleting and re-adding it; asks before overwriting another server with the same name.
  • Safe writes — every add, edit, or remove backs up the config file (.bak) before touching it, and never crashes on a malformed or empty config.
  • Confirm before delete — removing a server asks first.
  • i18n — full English/Russian UI, toggle at runtime with l.
  • Themeable — built-in Textual command palette (ctrl+p); your choice of theme and language persists between runs.

Installation

pip install mcp-hub-tui
mcp-hub

Requires Python 3.11+. Published on PyPI as mcp-hub-tui (the mcp-hub name was taken); the command is still mcp-hub.

From source

git clone git@github.com:d2202/mcp-hub.git
cd mcp-hub
./run.sh

run.sh creates a .venv on first run, installs the package, and launches the TUI.

Usage

Launch with ./run.sh, then:

  1. Dashboard — one row per agent: detected or not, how many servers, where its config file lives. Select a row to open it.
  2. Server List — the MCP servers configured for that agent. Invalid entries show why parsing failed instead of crashing.
  3. Add Wizard (a) — pick a server from the bundled catalog or enter one by hand, choose target agents, confirm.
  4. Edit (e) — opens the same wizard pre-filled with the selected server's command/args/env, scoped to the agent it's already on. Renaming asks to confirm if the new name collides with another server.

Keybindings

Key Action
enter open the selected row
a add server (from a server list)
e edit selected server (from a server list)
r remove server, asks to confirm (from a server list)
l toggle language (English / Russian)
? help screen
ctrl+p command palette (change theme, and more)
escape go back
q quit

Supported Agents

Agent Config file Format
Claude Code ~/.claude.json JSON, mcpServers
Codex CLI ~/.codex/config.toml TOML, [mcp_servers.<name>]
Antigravity ~/.gemini/config/mcp_config.json JSON, mcpServers

Adding another agent is one new adapter file under mcp_hub/adapters/; the rest of the app doesn't need to change.

Configuration

mcp-hub's own settings (language, theme) live in ~/.config/mcp-hub/settings.json and are written automatically — nothing to configure by hand. The bundled MCP server catalog is mcp_hub/catalog.yaml.

Development

python3.11 -m venv .venv
.venv/bin/pip install -e ".[dev]"
.venv/bin/pytest

Contributing

Issues and PRs welcome. Keep changes covered by tests (pytest) and follow the existing adapter/screen structure — see mcp_hub/adapters/ for the pattern a new agent adapter should follow.

License

MIT — see LICENSE.

Metadata

Release files for mcp-hub-tui 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-hub-tui 0.3.0
File Size Uploaded Provenance Actions
mcp_hub_tui-0.3.0.tar.gz 18.8 kB Without provenance Details for mcp_hub_tui-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for mcp-hub-tui 0.3.0
File Interpreter ABI Platform Actions
mcp_hub_tui-0.3.0-py3-none-any.whl Python 3 none any Details for mcp_hub_tui-0.3.0-py3-none-any.whl

Total release size: 39.1 kB

Release files / mcp_hub_tui-0.3.0.tar.gz

Download URL mcp_hub_tui-0.3.0.tar.gz
Size 18.8 kB
Tags Source
SHA-256 checksum
How to use checksums
988bef4b19b7dd8e8d694ef641f68491f0c9e2f824b3b07a96233402520c0fdf
BLAKE2b-256 checksum
How to use checksums
21fefeffd7ec5f99c8d12af51a7ac6596459b40b04192204efc47a768857ed44
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.0

Release files / mcp_hub_tui-0.3.0-py3-none-any.whl

Download URL mcp_hub_tui-0.3.0-py3-none-any.whl
Size 20.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7705497f61f85679e3fc54e2a711bc7cf46d1c866a51c8fdea10b32f0fa4e17b
BLAKE2b-256 checksum
How to use checksums
6b3185a2acf4e1735a009fc25652aaa30c16269f2fd728259a71715214d2e7f6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.11.0

Security for mcp-hub-tui 0.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page