mcpField
M
mcp-client-ref

mcp-client-ref

github.com/ananis25Frameworks & SDKs1Updated 91w ago
Repository

About mcp-client-ref

A terminal MCP client built with the Textual TUI library for testing and debugging MCP servers. Connects to multiple servers via configuration files and uses Claude Haiku for interaction.

Key features

  1. 01Terminal user interface (TUI)
  2. 02MCP server configuration management
  3. 03MCP server inspector and debugging
  4. 04Claude Haiku model integration
  5. 05Configurable LLM models

Use cases

  1. 01Test and debug MCP servers
  2. 02Interact with MCP services in the terminal
  3. 03Validate MCP server configurations
  4. 04Develop and maintain MCP applications

MCP support

Functions as an MCP client, connecting to multiple MCP servers via JSON configuration files and providing an inspector tool to debug server capabilities and resources.

Details

From the project README

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.