Happy slice of mcp pizzaMCP.pizza

EasyMCP

MCP.Pizza Chef: mshojaei77

EasyMCP is a flexible, beginner-friendly client for the Model Context Protocol (MCP) that supports connecting to SSE, NPX, and UV servers. It dynamically integrates available MCP tools from connected servers and enhances chat interactions using OpenAI API. EasyMCP simplifies server configuration and enables interactive query processing with real-time tool usage, making it ideal for exploring MCP server connections and chat enhancements.

Unmaintained · No commits in 17 months.

Use This MCP client To

Connect to MCP SSE servers for real-time event streaming Launch and connect to MCP NPX servers across platforms Run and manage MCP UV servers with custom configurations Dynamically discover and use tools exposed by MCP servers Integrate OpenAI API for enhanced interactive chat sessions Configure multiple MCP servers easily via scripts Process user queries with real-time tool invocation Explore MCP server capabilities with a beginner-friendly client

README

EasyMCP

EasyMCP is a flexible and beginner-friendly client for the Model Context Protocol (MCP). It allows you to connect to different types of MCP servers—SSE, NPX, and UV—so you can interact with various tools (e.g., file operations) and integrate with the OpenAI API for an enhanced chat experience.

Features

  • Multiple Server Support
    • SSE Servers: Connect via Server-Sent Events using a server URL.
    • NPX Servers: Launch servers using NPX commands (compatible with Windows and non-Windows systems).
    • UV Servers: Run servers configured with UV commands.
  • Dynamic Tool Integration:
    The client automatically retrieves available tools from the connected server and uses them to process user queries.
  • Interactive Chat Loop:
    Type queries and let the client process responses using OpenAI and the available MCP tools.
  • Configuration Management:
    Easily add new server configurations with add_server.py, which updates the appropriate configuration file (e.g., sse_servers.json, npx_servers.json, or uv_servers.json).

Prerequisites

  • Python 3.10+ (for compatibility with asyncio and modern async features)
  • A valid OpenAI API key (set in your .env file)
  • Other API keys as needed for additional integrations

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/EasyMCP.git
cd EasyMCP

  2. Create a virtual environment and activate it:

    On Windows:

    python -m venv .venv
.venv\Scripts\activate

    On macOS/Linux:

    python3 -m venv .venv
source .venv/bin/activate

  3. Install the required packages:

    pip install -r requirements.txt

  4. Set up your environment variables:
    Rename the provided .env.sample to .env (or create your own .env) and fill in the necessary API keys and configurations.

Server Configuration Files

EasyMCP uses several JSON configuration files to manage servers:

EasyMCP FAQ

How do I add a new MCP server configuration in EasyMCP?
Use the provided add_server.py script to add and update server configurations easily.
Can EasyMCP connect to multiple types of MCP servers?
Yes, it supports SSE, NPX, and UV servers for versatile connectivity.
Does EasyMCP support dynamic tool discovery from servers?
Yes, it automatically retrieves and integrates available tools from connected MCP servers.
How does EasyMCP enhance chat interactions?
It integrates with OpenAI API to process queries and use MCP tools dynamically for richer conversations.
Is EasyMCP suitable for beginners new to MCP?
Absolutely, it is designed to be beginner-friendly with simple configuration and usage.
What platforms does EasyMCP support for NPX servers?
It supports both Windows and non-Windows systems for NPX server launching.
Can I use EasyMCP without OpenAI integration?
While OpenAI integration enhances chat, EasyMCP can connect to MCP servers and use tools independently.
How does EasyMCP handle real-time server events?
It connects to SSE servers to receive and process server-sent events in real time.