Happy slice of mcp pizzaMCP.pizza

generic-mcp-client-chat

MCP.Pizza Chef: rom1504

The generic-mcp-client-chat is a versatile MCP client providing a real-time chat interface to interact with large language models (LLMs) and MCP tools. It supports multiple MCP servers, automatic tool discovery, and WebSocket communication, enabling seamless integration with various LLM providers like Claude and Anthropic. Designed with a modern, responsive UI, it facilitates error handling, connection monitoring, and multi-server support, making it ideal for developers experimenting with generic agents and UIs without writing new code.

Unmaintained · No commits in 16 months.

Use This MCP client To

Interact with multiple MCP servers via a unified chat interface Use and test various MCP tools like echo and repeat in real time Monitor connection status and handle errors during LLM interactions Experiment with generic agents without custom coding Integrate custom MCP servers for tailored LLM workflows Support multi-server environments with automatic tool discovery

README

Generic MCP Client Chat

A simple chat client that connects to an MCP (Model Control Protocol) server, allowing you to interact with LLMs and use MCP tools.

Vibe coded using cursor.

Goals

I believe we should have completely generic agents and completely generic UIs.

People should not need to write new code to write new agents. This UI is an experiment in building this generic MCP client.

Screenshot

MCP Chat Interface

Features

  • Real-time chat interface with Claude 3 Sonnet
  • Tool support (echo and repeat tools)
  • WebSocket-based communication
  • Modern, responsive UI
  • Connection status monitoring
  • Error handling and user feedback
  • Multi-server support with automatic tool discovery
  • Support for custom MCP servers

Prerequisites

  • Python 3.8 or higher
  • Anthropic API key

Setup

  1. Clone the repository:
git clone https://github.com/rom1504/generic-mcp-client-chat.git
cd generic-mcp-client-chat
  1. Create and activate a virtual environment (optional but recommended):
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Create a .env file in the project root:
ANTHROPIC_API_KEY=your_api_key_here

generic-mcp-client-chat FAQ

How do I connect the generic-mcp-client-chat to different MCP servers?
The client supports multi-server connections with automatic tool discovery via WebSocket communication, allowing easy integration with various MCP servers.
What LLM providers can I use with this client?
This client works with multiple LLM providers including Anthropic, Claude, and others compatible with MCP servers.
Is the client UI responsive and user-friendly?
Yes, it features a modern, responsive UI designed for real-time chat interactions and user feedback.
How does the client handle errors and connection issues?
It includes connection status monitoring and error handling to provide clear user feedback during interactions.
Can I add custom MCP tools to this client?
Yes, the client supports custom MCP servers and tools, enabling flexible extension of its capabilities.
What are the prerequisites for running this client?
You need Python 3.8 or higher and an Anthropic API key to set up and run the client.
How do I set up the generic-mcp-client-chat?
Clone the GitHub repository, create and activate a Python virtual environment, and configure your API keys as per the README instructions.
Does the client support real-time communication?
Yes, it uses WebSocket-based communication for real-time interaction with MCP servers and tools.