F
Flux159/mcp-chat
Generic client for trying MCP servers and agents
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
- Copy the command above
- Paste it as one entry under
mcpServersinclaude_desktop_config.json— local servers take command + args (example: clients) - Restart your client
Client config (built from the install command this repo gives)
{
"mcpServers": {
"flux159-mcp-chat": {
"command": "npx",
"args": ["mcp-chat"]
}
}
}Parsed from the README we fetched on 2026-11-05; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"flux159-mcp-chat": {
"command": "npx",
"args": ["mcp-chat"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio flux159-mcp-chat -- npx mcp-chat
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx mcp-chat
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx mcp-chat. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# mcp-chat
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
🌐 Language
English
| 简体中文
| 繁體中文
| 日本語
| 한국어
| हिन्दी
| ไทย
| Français
| Deutsch
| Español
| Italiano
| Русский
| Português
| Nederlands
| Polski
| العربية
| فارسی
| Türkçe
| Tiếng Việt
| Bahasa Indonesia
| অসমীয়া
Open Source Generic MCP Client for testing & evaluating mcp servers and agents
## Quickstart
Make sure that you have ANTHROPICAPIKEY exported in your environment or in a .env file in the root of the project. You can get an API key by signing up at the Anthropic Console keys page.
Simple use case that spawns an interactive chat prompt with the filesystem MCP server from CLI:
shell
npx mcp-chat --server "npx -y @modelcontextprotocol/server-filesystem /Users/$USER/Desktop"
This will open up a chat prompt that you can use to interact with the servers and chat with an LLM.
## Config
You can also just specify your claudedesktopconfig.json (Mac):
shell
npx mcp-chat --config "~/Library/Application Support/Claude/claudedesktopconfig.json"
Or (Windows):
shell
npx mcp-chat --config "%APPDATA%\Claude\claudedesktopconfig.json"
## Web mode
https://github.com/user-attachments/assets/b7e8a648-8084-4955-8cdf-fc6eb141572e
You can also run mcp-chat in web mode by specifying the --web flag (make sure to have ANTHROPICAPIKEY exported in your environment):
shell
npx mcp-chat --web
In web mode, you can start new chats, send messages to the model, and dynamically configure the mcp servers via the UI - no need to specify on the command line. In addition, chats created via the Web UI are saved to ~/.mcpchats/chats just like chats created via the CLI.
## Features
[x] Run via CLI in interactive mode or directly pass prompts with -p
[x] Web mode to chat with models via a web interface --web
[x] Connect to any MCP server (JS, Python, Docker) in production or during development
[x] Choose between models with -m
[x] Customize system prompt with --system
[x] Saves chat history with settings in ~/.mcpchat/chats including web chats
[x] Save and restore commands in ~/.mcpchat/history
[x] View tool call output and arguments directly in chat to help debug mcp servers
## CLI Usage
Run prompts via CLI with the -p flag:
shell
npx mcp-chat --server "npx mcp-server-kubernetes" -p "List the pods in the default namespace"
This runs the prompt with the kubenertes mcp-server & exits after the response is received on stdout.
Choose a model to chat with via CLI with the -m flag:
shell
npx mcp-chat --server "npx mcp-server-kubernetes" -m "claude-3.5"
Uses the model claude-3.5 to chat with. Note that currently only Anthropic models are supported.
Custom system prompt:
--system flag can be used to specify a system prompt:
shell
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"
## Remote MCP servers
Pass a Streamable HTTP endpoint URL to --server instead of a local command:
shell
npx mcp-chat --server "https://example.com/mcp" -p "What tools do you have available?"
Any http:// or https:// server string is treated as a Streamable HTTP endpoint, both in the CLI and in web mode chat settings. Legacy SSE endpoints and servers that require authentication are not currently supported.
English
| 简体中文
| 繁體中文
| 日本語
| 한국어
| हिन्दी
| ไทย
| Français
| Deutsch
| Español
| Italiano
| Русский
| Português
| Nederlands
| Polski
| العربية
| فارسی
| Türkçe
| Tiếng Việt
| Bahasa Indonesia
| অসমীয়া
Open Source Generic MCP Client for testing & evaluating mcp servers and agents
## Quickstart
Make sure that you have ANTHROPICAPIKEY exported in your environment or in a .env file in the root of the project. You can get an API key by signing up at the Anthropic Console keys page.
Simple use case that spawns an interactive chat prompt with the filesystem MCP server from CLI:
shell
npx mcp-chat --server "npx -y @modelcontextprotocol/server-filesystem /Users/$USER/Desktop"
This will open up a chat prompt that you can use to interact with the servers and chat with an LLM.
## Config
You can also just specify your claudedesktopconfig.json (Mac):
shell
npx mcp-chat --config "~/Library/Application Support/Claude/claudedesktopconfig.json"
Or (Windows):
shell
npx mcp-chat --config "%APPDATA%\Claude\claudedesktopconfig.json"
## Web mode
https://github.com/user-attachments/assets/b7e8a648-8084-4955-8cdf-fc6eb141572e
You can also run mcp-chat in web mode by specifying the --web flag (make sure to have ANTHROPICAPIKEY exported in your environment):
shell
npx mcp-chat --web
In web mode, you can start new chats, send messages to the model, and dynamically configure the mcp servers via the UI - no need to specify on the command line. In addition, chats created via the Web UI are saved to ~/.mcpchats/chats just like chats created via the CLI.
## Features
[x] Run via CLI in interactive mode or directly pass prompts with -p
[x] Web mode to chat with models via a web interface --web
[x] Connect to any MCP server (JS, Python, Docker) in production or during development
[x] Choose between models with -m
[x] Customize system prompt with --system
[x] Saves chat history with settings in ~/.mcpchat/chats including web chats
[x] Save and restore commands in ~/.mcpchat/history
[x] View tool call output and arguments directly in chat to help debug mcp servers
## CLI Usage
Run prompts via CLI with the -p flag:
shell
npx mcp-chat --server "npx mcp-server-kubernetes" -p "List the pods in the default namespace"
This runs the prompt with the kubenertes mcp-server & exits after the response is received on stdout.
Choose a model to chat with via CLI with the -m flag:
shell
npx mcp-chat --server "npx mcp-server-kubernetes" -m "claude-3.5"
Uses the model claude-3.5 to chat with. Note that currently only Anthropic models are supported.
Custom system prompt:
--system flag can be used to specify a system prompt:
shell
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"
## Remote MCP servers
Pass a Streamable HTTP endpoint URL to --server instead of a local command:
shell
npx mcp-chat --server "https://example.com/mcp" -p "What tools do you have available?"
Any http:// or https:// server string is treated as a Streamable HTTP endpoint, both in the CLI and in web mode chat settings. Legacy SSE endpoints and servers that require authentication are not currently supported.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/flux159-mcp-chat/)
- Source
- awesome · https://github.com/Flux159/mcp-chat
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.