mcp-chat

@flux159

About mcp-chat

Open Source Generic MCP Client for testing & evaluating mcp servers and agents

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-chat": {
      "command": "npx",
      "args": [
        "mcp-chat",
        "--server",
        "npx -y @modelcontextprotocol/server-filesystem /Users/$USER/Desktop"
      ]
    }
  }
}

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is mcp-chat?

mcp-chat is an open source generic MCP client for testing and evaluating MCP servers and agents. It provides a CLI and web interface for interacting with MCP servers through an LLM.

How to use mcp-chat?

Run via npx mcp-chat with flags like --server, --config, --web, -m (model), -p (prompt), or --system (system prompt). Requires the ANTHROPIC_API_KEY environment variable set. For web mode, use --web and configure servers through the UI.

Key features of mcp-chat

Run CLI in interactive mode or with -p flag
Web mode for chatting via a web interface
Connect to any MCP server (JS, Python, Docker)
Choose between Anthropic models with -m
Customize system prompt with --system
Saves chat history to ~/.mcpchat/chats

Use cases of mcp-chat

Test MCP servers during development (local builds)
Run one‑off prompts with MCP servers (e.g., Kubernetes)
Interactive chat with an LLM and connected tools
Debug tool call output and arguments

FAQ from mcp-chat

What LLM models are supported?

Currently only Anthropic models (e.g., claude-3.5) are supported.

How do I connect to a local MCP server?

Use --server with a command (e.g., npx mcp-server-kubernetes) or pass a local script (e.g., node /path/to/index.js or uv run weather.py).

Where is chat history saved?

Chats are saved in ~/.mcpchat/chats (both CLI and web mode).

Can I run mcp-chat without a CLI server argument?

Yes, in web mode (--web) you can dynamically configure MCP servers via the UI.

Do I need an API key?

Yes, set the ANTHROPIC_API_KEY environment variable or place it in a .env file.

Frequently asked questions

What LLM models are supported?

Currently only Anthropic models (e.g., `claude-3.5`) are supported.

How do I connect to a local MCP server?

Use `--server` with a command (e.g., `npx mcp-server-kubernetes`) or pass a local script (e.g., `node /path/to/index.js` or `uv run weather.py`).

Where is chat history saved?

Chats are saved in `~/.mcpchat/chats` (both CLI and web mode).

Can I run mcp-chat without a CLI server argument?

Yes, in web mode (`--web`) you can dynamically configure MCP servers via the UI.

Do I need an API key?

Yes, set the `ANTHROPIC_API_KEY` environment variable or place it in a `.env` file.

Comments

Basic information

More AI & Agents MCP servers

🛡️ A.I.G（AI-Infra-Guard）

Tencent

A full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.

4.1K

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K

Agentery

ntlgnc

Free MCP for live and historical pricing for 13,000+ agents and MCPs. Never knowingly pay too much... or charge too little. Know the going rate. https://agentery.com.

1MCP - One MCP Server for All

1mcp-app

A unified Model Context Protocol server implementation that aggregates multiple MCP servers into one.

468