Happy slice of mcp pizzaMCP.pizza

mcp-cli

MCP.Pizza Chef: Deniscartin

mcp-cli is a comprehensive Model Context Protocol client offering command-line, graphical, and API interfaces. It enables users to connect to MCP servers, manage multiple server configurations, run natural language queries leveraging MCP tools, and explore available tool capabilities. Designed for seamless interaction with MCP servers, it supports efficient querying and tool discovery across diverse MCP environments.

Use This MCP client To

Manage multiple MCP server configurations via CLI or GUI Run natural language queries against MCP servers Discover and explore available MCP tools and their functions Integrate MCP server interactions into custom workflows via API Test and debug MCP server responses interactively

README

MCP CLI, GUI & API - Model Context Protocol Client

A comprehensive toolkit for interacting with Model Context Protocol (MCP) servers. This project provides both a graphical user interface and command-line tools for managing MCP servers, running queries against them using OpenAI models, and discovering available tools.

What is Model Context Protocol?

The Model Context Protocol (MCP) is an open standard for exposing tools and capabilities to large language models (LLMs). It enables LLMs to access external tools like web browsers, databases, and APIs in a standardized way. This project provides a client implementation that makes it easy to:

  • Connect to MCP-compatible servers
  • Manage multiple server configurations
  • Run natural language queries that leverage MCP tool capabilities
  • Explore available tools and their functionality

Project Components

This project consists of three main components:

  1. Command-Line Interface (CLI): For managing servers and running queries in a terminal
  2. Graphical User Interface (GUI): A PyQt5-based desktop application for visual interaction
  3. API Server: A RESTful API that exposes MCP CLI functionality via HTTP, enabling integration with web applications and other services

Directory Structure

mcp-cli-project/
├── mcp_cli/                 # Core Python package
│   ├── api/                 # RESTful API server implementation
│   │   ├── server.py        # Flask-based API server
│   │   └── README.md        # API documentation
│   ├── gui/                 # GUI implementation using PyQt5
│   ├── core.py              # Core functionality shared by CLI, implementation
├── mcpgui/                  # Web-based GUI (Next.js frontend)
│   ├── src/                 # Source code for the web interface
│   └── public/              # Static assets
├── bin/                     # Executable scripts
│   ├── mcp_gui.py           # Script to start the GUI
│   └── mcp_cli.py           # Script to run CLI commands
├── config/                  # Configuration files
│   └── config.json          # Server configurations
├── docs/                    # Documentation
└── setup.py                 # Package installation configuration

mcp-cli FAQ

How do I connect mcp-cli to an MCP server?
Use the CLI or GUI to add server configurations with the server URL and credentials, then connect to start querying.
Can mcp-cli manage multiple MCP servers simultaneously?
Yes, it supports managing multiple server configurations and switching between them easily.
What interfaces does mcp-cli provide?
It offers a command-line interface, graphical user interface, and an API for flexible interaction.
How can I run natural language queries using mcp-cli?
Use the CLI or GUI query commands to send natural language requests that leverage MCP tool capabilities on connected servers.
Is mcp-cli compatible with different LLM providers?
Yes, it works with OpenAI, Anthropic Claude, and Google Gemini models for querying MCP servers.
Can I discover available tools on an MCP server using mcp-cli?
Yes, mcp-cli provides commands to explore and list tools exposed by connected MCP servers.
How does mcp-cli help in debugging MCP servers?
It allows interactive querying and inspection of server responses to test tool functionality and data exposure.
Does mcp-cli support automation or scripting?
Yes, its API and CLI can be integrated into scripts and automation workflows for MCP server interactions.