flux159_mcp_chat
by Flux159MCP Chat Client for LLM Integration
Overview
The MCP Chat Client is an open-source tool designed for testing and evaluating MCP servers and agents. It provides a seamless interface for interacting with Large Language Models (LLMs) and MCP servers, both via CLI and a web interface.
Features
- Interactive CLI Mode: Run interactive chat sessions directly from the command line.
- Web Mode: Use a web interface to chat with models and configure MCP servers dynamically.
- Multi-Server Support: Connect to any MCP server (JS, Python, Docker) in production or during development.
- Model Selection: Choose between different models using the
-mflag. - Custom System Prompts: Customize system prompts with the
--systemflag. - Chat History: Save chat history and settings in
~/.mcpchat/chats. - Tool Call Debugging: View tool call output and arguments directly in the chat for debugging.
Quickstart
- Ensure
ANTHROPIC_API_KEYis exported in your environment or in a.envfile. - Run the following command to start an interactive chat session:
shell npx mcp-chat --server "npx -y @modelcontextprotocol/server-filesystem /Users/$USER/Desktop"
Configuration
You can specify your configuration file using the --config flag:
- Mac:
shell
npx mcp-chat --config "~/Library/Application Support/Claude/claude_desktop_config.json"
- Windows:
shell
npx mcp-chat --config "%APPDATA%\Claude\claude_desktop_config.json"
Web Mode
Run the client in web mode with the --web flag:
npx mcp-chat --web
In web mode, you can start new chats, send messages, and configure MCP servers via the UI.
CLI Usage
Run prompts directly via CLI with the -p flag:
npx mcp-chat --server "npx mcp-server-kubernetes" -p "List the pods in the default namespace"
Choose a model with the -m flag:
npx mcp-chat --server "npx mcp-server-kubernetes" -m "claude-3.5"
Customize the system prompt with the --system flag:
npx mcp-chat --system "Explain the output to the user in pirate speak." --server "npx mcp-server-kubernetes" -p "List the pods in the default namespace"
For Developers of MCP Servers
Test local builds of MCP servers with the following commands:
- Node JS:
shell
npx mcp-chat --server "/path/to/mcp-server-kubernetes/dist/index.js"
- Python:
shell
npx mcp-chat --server "uv --directory /path/to/mcp-server-weather/ run weather.py"
Development
- Clone the repository:
shell git clone https://github.com/Flux159/mcp-chat - Install dependencies:
shell bun install - Run the CLI:
shell bun run dev
Testing
Run tests with:
bun run test
Building
Build the project with:
bun run build
Publishing
Publish the package with:
bun run publish
Project Structure
├── src/
│ ├── index.ts # Main client implementation & CLI params
│ ├── constants.ts # Default constants
│ ├── interactive.ts # Interactive chat prompt handling & logic
├── test/ # Test files
│ ├── cli.test.ts # Test CLI params
│ ├── config.test.ts # Test config file parsing
Publishing New Release
- Go to the releases page.
- Click "Draft New Release".
- Create a new tag using "v{major}.{minor}.{patch}" semver format.
- Write a release title and description.
- Click "Publish Release".
License
About
The MCP Chat Client is an open-source tool for testing and evaluating MCP servers and agents. It is available on npm.
Invite Gmail Contacts
