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

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.

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

Category

AI & Agents

License

MIT

Transports

stdio

Author

flux159

More AI & Agents MCP servers

欢迎来到 智言平台

Shy2593666979

AgentChat 是一个基于 LLM 的智能体交流平台，内置默认 Agent 并支持用户自定义 Agent。通过多轮对话和任务协作，Agent 可以理解并协助完成复杂任务。项目集成 LangChain、Function Call、MCP 协议、RAG、Memory、HITL、Skill、Milvus 和 ElasticSearch 等技术，实现高效的知识检索与工具调用，使用 FastAPI 构建高性能后端服务。

797

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K

Shell and Coding agent for Claude and other mcp clients

rusiaaman

Shell and coding agent on mcp clients

666

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

Model Context Protocol Server for Home Assistant

tevonsb

A MCP server for Home Assistant

574