# mcp-chat

> MCP Server

Mcp-chat is an open-source MCP client for testing and evaluating MCP servers and agents, offering both CLI and web interfaces to interact with models, customize prompts, and save chat histories.

## Overview

- **Category:** Developer Tools
- **Language:** TypeScript
- **Stars:** 136
- **Forks:** 0
- **Owner:** Flux159
- **GitHub:** https://github.com/Flux159/mcp-chat
- **Homepage:** https://www.npmjs.com/package/mcp-chat
- **Created:** 2025-03-18T21:20:38+00:00
- **Updated:** 2025-03-28T13:28:01+00:00
- **Source:** https://model-context-protocol.com/servers/open-source-mcp-client-testing-evaluation

## Setup

## Setup

1.  Make sure that you have `ANTHROPIC_API_KEY` exported in your environment or in a .env file in the root of the project.
2.  Get an API key by signing up at the [Anthropic Console keys page](https://console.anthropic.com/settings/keys).
3.  Install dependencies: `git clone https://github.com/Flux159/mcp-chat`, `bun install`.
4.  Run the CLI: `bun run dev`.

## Tools

## Available Tools

1.  Run via CLI in interactive mode or directly pass prompts with `-p` (Allows interaction via CLI or direct prompt execution).
2.  Web mode to chat with models via a web interface `--web` (Enables web-based chat interface).
3.  Connect to any MCP server (JS, Python, Docker) in production or during development (Supports various MCP server types).
4.  Choose between models with `-m` (Allows model selection).
5.  Customize system prompt with `--system` (Enables custom system prompts).
6.  Saves chat history with settings in `~/.mcpchat/chats` including web chats (Saves chat history).
7.  Save and restore commands in `~/.mcpchat/history` (Saves and restores command history).
8.  View tool call output and arguments directly in chat to help debug mcp servers (Facilitates MCP server debugging).