mcp-chat

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

Catalog onlyCatalog onlySTDIO

Overview

mcp-chat is an open-source generic MCP (Model Context Protocol) client designed for testing and evaluating MCP servers and agents.

To use mcp-chat, ensure you have the ANTHROPIC_API_KEY set in your environment. You can start an interactive chat prompt with a filesystem MCP server using the command: npx mcp-chat --server "npx -y @modelcontextprotocol/server-filesystem /Users/username/Desktop".

Interactive chat prompt for MCP servers. - Support for various MCP server types including filesystem and Kubernetes. - Ability to specify custom system prompts and models for interaction. - CLI usage for running prompts and interacting with models.

Testing and evaluating different MCP servers.
Interacting with large language models (LLMs) through chat prompts.
Developing and debugging custom MCP servers.

Add to your AI client

Use these steps to connect mcp-chat in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-chat-flux159": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-chat-flux159"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-chat-flux159": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-chat-flux159"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-chat-flux159": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-chat-flux159"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-chat-flux159": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-chat-flux159"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-chat-flux159": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-chat-flux159"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-chat-flux159": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-chat-flux159"
      ]
    }
  }
}

FAQ

What is an MCP server?

An MCP server is a server that implements the Model Context Protocol, allowing for interaction with models in a structured way.

Is mcp-chat free to use?

Yes! mcp-chat is open-source and free to use for everyone.

What programming languages does mcp-chat support?

mcp-chat primarily supports Node.js and Python for server interactions.

Developer tools