mcp-tui

mcp-tui is a terminal user interface (TUI) tool built with Python. It provides an easy-to-use interface for users, designed to help developers work efficiently. It focuses on command-line operations and offers a variety of features that are beneficial for scripting and automation tasks.

GitHub Stars

14

User Rating

Not Rated

Favorites

0

Views

71

Forks

1

Issues

0

README
MCP TUI
An MCP Host application that runs in your terminal; written in Python

If you like this project, please consider starring the repo on GitHub! You can also upvote on Hacker News. ⭐️

Pull requests are very welcome! If you have ideas, bug fixes, or improvements, please open a PR.

A Python TUI app using uv, Typer, and Textual to list MCP servers from a mcp.json file.

Screenshots
MCP server list

MCP server list

Show logs for an MCP server

Show logs for an MCP server

List tools for an MCP server

List tools for an MCP server

Invoke a tool

Invoke a tool

Installation (easy) without development

This is if you just want to use the app and not contribute to the development,
which I will not judge you for (even though LLMs make it so easy to vibe-code
and you could just vibe-code some stuff and make a PR but that's okay it's cool.
It is cool).

Install uv if you don't have it already.

uv tool install git+https://github.com/msabramo/mcp-tui
Installation for development

Clone the repository:

git clone git@github.com:msabramo/mcp-tui.git
cd mcp-tui

Install uv if you don't have it already.

Install dependencies using uv:

uv sync
Usage

Run the app with:

uv run python mcp_tui/app.py ~/.cursor/mcp.json