mcp-chat
by flux159
mcp-chat is an open-source generic MCP (Model Context Protocol) client designed for testing and evaluating MCP servers and agents. It allows users to interact with MCP servers through a CLI or web interface, facilitating the development and debugging of MCP-based applications.
Last updated: N/A
What is mcp-chat?
mcp-chat is a versatile client for interacting with MCP servers. It provides both a command-line interface (CLI) and a web interface for sending prompts, receiving responses, and debugging MCP server implementations.
How to use mcp-chat?
To use mcp-chat, you can either run it via the CLI with npx mcp-chat and specify server details, configuration files, or prompts. Alternatively, you can use the --web flag to launch a web interface for interactive chat sessions. Configuration can be done via command-line arguments or a configuration file. Make sure you have an Anthropic API key set up.
Key features of mcp-chat
Interactive CLI mode
Web interface for chatting with models
Connects to any MCP server (JS, Python, Docker)
Model selection via CLI
Customizable system prompts
Chat history saved with settings
Command history saved and restored
Tool call output and argument viewing for debugging
Use cases of mcp-chat
Testing and evaluating MCP server implementations
Debugging MCP server integrations
Prototyping MCP-based applications
Interacting with LLMs through MCP servers
FAQ from mcp-chat
How do I run mcp-chat in web mode?
How do I run mcp-chat in web mode?
Use the --web flag: npx mcp-chat --web. Ensure you have the ANTHROPIC_API_KEY environment variable set.
How do I specify a custom system prompt?
How do I specify a custom system prompt?
Use the --system flag followed by your desired prompt: npx mcp-chat --system "Explain the output in pirate speak." ...
Can I use mcp-chat with a local build of an MCP server?
Can I use mcp-chat with a local build of an MCP server?
Yes, you can specify the path to your local server using the --server flag. See the README for examples with Node.js and Python.
Where are chat histories saved?
Where are chat histories saved?
Chat histories are saved in ~/.mcpchats/chats, including chats created via the web UI.
How do I choose a specific model to chat with?
How do I choose a specific model to chat with?
Use the -m flag followed by the model name: npx mcp-chat -m "claude-3.5" ...