mcp-chat

by flux159

135 stars

708 downloads

Not rated

GitHub Website

About

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

Details

Author: flux159
GitHub stars: 135
Downloads: 708
Categories: AI

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name mcp-chat

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

mcp-chat

<div align="right"> <details> <summary >🌐 Language</summary> <div> <div align="center"> <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=en">English</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=zh-CN">简体中文</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=zh-TW">繁體中文</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=ja">日本語</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=ko">한국어</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=hi">हिन्दी</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=th">ไทย</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=fr">Français</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=de">Deutsch</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=es">Español</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=it">Italiano</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=ru">Русский</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=pt">Português</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=nl">Nederlands</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=pl">Polski</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=ar">العربية</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=fa">فارسی</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=tr">Türkçe</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=vi">Tiếng Việt</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=id">Bahasa Indonesia</a> | <a href="https://openaitx.github.io/view.html?user=Flux159&project=mcp-chat&lang=as">অসমীয়া</ </div> </div> </details> </div> Open Source Generic MCP Client for testing & evaluating mcp servers and agents <p align="center">

</p>

Quickstart

Make sure that you have ANTHROPIC_API_KEY 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 claude_desktop_config.json (Mac):

shell
npx mcp-chat --config "~/Library/Application Support/Claude/claude_desktop_config.json"



Or (Windows):

shell
npx mcp-chat --config "%APPDATA%\Claude\claude_desktop_config.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 ANTHROPIC_API_KEY

 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"



ENV vars


Mcp-chat supports passing through env vars to mcp servers. This is not standardized in the mcp spec though and other clients may not do this with dynamic env var values - read more here about standard stdio mcp clients.

shell
KUBECONFIG="~/.kube/config" npx mcp-chat --server "npx mcp-server-kubernetes"



For developers of mcp-servers


You can pass in a local build of a python or node mcp-server to test it out with mcp-chat:

Node JS:

``shell

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

mcp-chat

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

mcp-chat

Quickstart

Config

Web mode

Features

CLI Usage

ENV vars

For developers of mcp-servers

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

mcp-chat

Quickstart

Config

Web mode

Features

CLI Usage

ENV vars

For developers of mcp-servers

Install

More like this

Context 7

1Panel

🔎 GPT Researcher

Serena

FastMCP v2 🚀

MaxKB