EasyMCP

What is EasyMCP?

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

How to use EasyMCP?

Clone the repository, create a virtual environment, install dependencies, and set up a .env file with your OpenAI API key. Run python main.py, then select a server from the configuration files (sse_servers.json, npx_servers.json, uv_servers.json). Type queries like “read a PDF file” or “use read_file tool” to interact with the connected MCP tools. New servers can be added by running python add_server.py.

Key features of EasyMCP

• Connect to SSE, NPX, and UV MCP servers
• Automatically retrieve and integrate available server tools
• Interactive chat loop powered by the OpenAI API
• Easily add new server configurations with add_server.py
• Lightweight, Python‑based CLI client

Use cases of EasyMCP

• Read and process local files using a filesystem MCP server
• Query a SQLite database through a UV‑based MCP server
• Integrate external tools (e.g., time, weather) via SSE‑based servers
• Prototype and test custom MCP tool integrations quickly

FAQ from EasyMCP

What is EasyMCP and what does it do?

EasyMCP is an MCP client that connects to SSE, NPX, and UV servers, retrieves their tools, and uses the OpenAI API to process user queries with those tools.

Which platforms and models are supported?

EasyMCP runs on any system with Python 3.10+ (Windows, macOS, Linux). It relies on the OpenAI API, so any OpenAI model (e.g., GPT‑4) accessible via your API key can be used.

Does EasyMCP support MCP servers?

Yes, it supports three server types: SSE servers (via URL), NPX servers (via npx commands), and UV servers (via uv commands). Configuration is stored in JSON files.

Is EasyMCP free and open source?

Yes. EasyMCP is open source under the MIT License and has no associated cost beyond your own API keys and infrastructure.

What are the prerequisites to use EasyMCP?

Python 3.10+, a valid OpenAI API key set in a .env file, and any additional API keys required by the MCP servers you connect to.