READMEmain

MCP-REPL

A lightweight REPL (Read-Eval-Print Loop) for interacting with various services through MCP (Model Context Protocol).

Overview

mcp-repl is designed for efficient development, debugging, and testing of MCP servers. It provides an intuitive command-line interface that's simpler than using the Cloud Desktop app, allowing developers to quickly:

Send queries to MCP servers
View detailed tool execution
Automatically save chat history
Test multiple MCP services simultaneously

Installation

Install via pip or uv:

uv add mcp-repl

Usage

Start the REPL:

uv run mcp-repl --config path/to/config.json

Examples

🔥 Check out our real-world examples to see mcp-repl in action! 🔥

Databases - Database administrators: See how to query, monitor, and manage your databases with natural language
Infrastructure - DevOps engineers: Explore examples for managing cloud resources, monitoring systems, and automating infrastructure tasks
Self-Healing K8s Agent with LibreChat + MCP - K8S Agent

Each example includes sample configurations and common usage patterns to help you get started quickly.

Optional Flags

--auto-approve-tools: Automatically approve all tool executions
--always-show-full-output: Always display complete tool outputs
--chat-history-dir PATH: Directory to save chat history (default: ./chat_history)

Development Installation

Clone and install in editable mode:

git clone https://github.com/yourusername/mcp-repl.git
cd mcp-repl
uv venv

Testing

Comprehensive integration tests are included to verify functionality:

Run all tests:

uv run pytest