ananis25
MCP Server
ananis25
public

mcp client ref

TUI to test model context protocol servers

Repository Info

1
Stars
0
Forks
1
Watchers
0
Issues
Python
Language
MIT License
License

About This Server

TUI to test model context protocol servers

Model Context Protocol (MCP) - This server can be integrated with AI applications to provide additional context and capabilities, enabling enhanced AI interactions and functionality.

Documentation

# mcp-client-ref

A [model context protocol](https://modelcontextprotocol.io/) client that runs in the terminal. Thanks to the [Textual](https://textual.textualize.io/) TUI library. 

## Installation

To run the client, install the dependencies and run `scripts/client.py`. Pass the path to the MCP servers config file as an argument.

```bash
uv sync
uv run scripts/client.py <mcp_servers_config_path>
```

- The MCP servers config file is a JSON file that lists the MCP servers you want the client to connect to. It follows the [format used](https://modelcontextprotocol.io/quickstart/user) by the `Claude Desktop` app.
- The client uses the Claude Haiku model by default, so you'll need to keep the `ANTHROPIC_API_KEY` in the `.env` file. It uses the magentic library to connect to the LLM APIs; you can configure a different model to use in the client code. 


### MCP server inspector 

You can debug/test the servers by opening up the inspector screen using the command palette in the app. 

Quick Start

1

Clone the repository

git clone https://github.com/ananis25/mcp-client-ref
2

Install dependencies

cd mcp-client-ref
npm install
3

Follow the documentation

Check the repository's README.md file for specific installation and usage instructions.

Repository Details

Ownerananis25
Repomcp-client-ref
Language
Python
LicenseMIT License
Last fetched8/8/2025

Recommended MCP Servers

💬

Discord MCP

Enable AI assistants to seamlessly interact with Discord servers, channels, and messages.

integrationsdiscordchat
🔗

Knit MCP

Connect AI agents to 200+ SaaS applications and automate workflows.

integrationsautomationsaas
🕷️

Apify MCP Server

Deploy and interact with Apify actors for web scraping and data extraction.

apifycrawlerdata
🌐

BrowserStack MCP

BrowserStack MCP Server for automated testing across multiple browsers.

testingqabrowsers

Zapier MCP

A Zapier server that provides automation capabilities for various apps.

zapierautomation