MCP.so
Sign In

mcp-chat

@flux159

RepositoryHomepage

About mcp-chat

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

#ai#mcp#llm

Basic information

Category

AI & Agents

License

MIT

Runtime

node

Transports

stdio

Publisher

flux159

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

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

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.

Comments

More AI & Agents MCP servers

mcp-hfspace MCP Server 🤗

evalstate

MCP Server to Use HuggingFace spaces, easy configuration and Claude Desktop mode.

387

Sequential Thinking Multi-Agent System (MAS)

FradSer

An advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.

306

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K

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

MCP-LLM Bridge

patruff

Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

976