MCP ExplorerExplorer

Mcp Client Ref

@ananis25on 10 months ago
1 MIT
FreeCommunity
AI Systems
TUI to test model context protocol servers

Overview

What is Mcp Client Ref

mcp-client-ref is a terminal-based client for testing Model Context Protocol (MCP) servers, utilizing the Textual TUI library for an interactive user interface.

Use cases

Use cases include testing and debugging MCP servers, experimenting with different models, and developing applications that rely on the Model Context Protocol for communication.

How to use

To use mcp-client-ref, install the necessary dependencies and run the command ‘uv run scripts/client.py <mcp_servers_config_path>’ in the terminal, where ‘<mcp_servers_config_path>’ is the path to your MCP servers configuration JSON file.

Key features

Key features include a terminal user interface for easy interaction, the ability to connect to multiple MCP servers, and an integrated inspector for debugging and testing server responses.

Where to use

mcp-client-ref is suitable for developers and testers working with Model Context Protocol servers, particularly in environments where terminal-based applications are preferred.

Content

mcp-client-ref

A model context protocol client that runs in the terminal. Thanks to the Textual 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.

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 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.

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers