MCP Chat

@flux159

Repository Homepage

Basic information

About MCP Chat

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

#ai #mcp #llm

MCP Chat 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"
      ]
    }
  }
}

MCP Chat tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

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

More AI & Agents MCP servers

Legion MCP

faulkj

MCP-native LLM councils for debates, juries, blind panels, voting, refinement, and custom multi-model deliberation.

OpenZiti MCP Gateway

openziti

NetFoundry MCP Gateway enables secure, isolated access to Model Context Protocol (MCP) tools across distributed systems without exposing public endpoints. Zero trust gateway for MCP servers. Aggregate, filter, and secure

toll402-mcp

toll402

Toll402 — one MCP server with 2,600+ pay-per-call tools for AI agents: web and PDF reading, structured extraction, provenance (human vs synthetic), trusted lookup with citations, a 4.6M-business verified directory, 50+

scvd.store

seancrecord

scvd.store is an evidence observatory for agentic commerce. Independent signed observation of what other people's endpoints, artifacts and payments actually did among other things. USDC on Base, Arbitrum One, World Chain

Hostinger

hostinger

Model Context Protocol (MCP) server for Hostinger API. If you don't want to install or run anything locally, connect directly to Hostinger's hosted MCP server: This opens a browser window to authorize via OAuth. Once app

148