Metadata-Version: 2.4
Name: tappy-mcp
Version: 0.1.2
Summary: MCP management + inspector + monitoring tool: discover, configure, run, inspect and monitor MCP servers across AI clients.
Project-URL: Homepage, https://github.com/aadhil96/tappy
Project-URL: Repository, https://github.com/aadhil96/tappy
Project-URL: Issues, https://github.com/aadhil96/tappy/issues
Author: aadhil96
License-Expression: MIT
License-File: LICENSE
Keywords: ai,claude,cli,cursor,inspector,llm,mcp,model-context-protocol,monitoring
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Requires-Dist: mcp>=1.2
Requires-Dist: rich>=13
Provides-Extra: dev
Requires-Dist: build>=1.2; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Requires-Dist: twine>=5; extra == 'dev'
Description-Content-Type: text/markdown

# Tappy

**One tool to manage, inspect and monitor every MCP server you run.**

Works across Claude Desktop, Claude Code, Cursor — and any client with an `mcpServers`
config.

## Installation

Requires Python 3.11+. The package is `tappy-mcp`; it installs the `tappy` command.

```bash
pip install tappy-mcp
```

Or, isolated in its own environment (recommended for terminal tools):

```bash
pipx install tappy-mcp
# or
uv tool install tappy-mcp
```

Or run it instantly without installing (the `npx` equivalent):

```bash
uvx tappy-mcp status
```

Verify the install:

```bash
tappy --version
tappy help          # grouped overview of every command
```

## Quick start

```bash
tappy list            # every server across every client
tappy status          # ...with live health, latency and tool counts
tappy inspect <name>  # full report: status + tools + resources + prompts
tappy watch           # live, auto-refreshing health monitor
```

## What it does

MCP servers are the plugins that give AI tools their real-world powers — but each AI
client stores them in its own JSON config file, with no way to see whether a server
actually works or what it exposes. Tappy reads every client's config into one view and
lets you:

- **Manage** — `add` / `remove` / `enable` / `disable` servers without hand-editing
  JSON. Every write is atomic, diff-previewable (`--dry-run`), backed up first, and
  reversible with `tappy restore`.
- **Inspect** — talk the real MCP protocol: list a server's tools/resources/prompts,
  `call` a tool, `read` a resource, render a `prompt` — even against a server that
  isn't installed anywhere yet (`--command` / `--url`).
- **Monitor** — `status` / `watch` / `probe` show live health, handshake latency and
  tool counts, probed concurrently over the protocol.
- **Secure** — `pin` a server's tool definitions, then `verify` (or just `status`)
  flags if they change behind your back — catching post-approval "rug-pulls".
- **Standardize** — a git-tracked team registry: `apply` provisions it to everyone,
  `lint` gates CI on drift, `sync` copies servers between clients.

Every data command supports `--json` and meaningful exit codes, so it drops straight
into scripts, dotfiles and CI.

## Documentation

- [Full README](https://github.com/aadhil96/tappy#readme) — features, command reference,
  architecture
- [User Guide](https://github.com/aadhil96/tappy/blob/main/GUIDE.md) — hands-on manual:
  every command, workflows, scripting, troubleshooting
- [Changelog](https://github.com/aadhil96/tappy/blob/main/CHANGELOG.md)
- [Issues](https://github.com/aadhil96/tappy/issues)

## License

MIT
