easymcp 0.4.0

Add your description here

EasyMCP

EasyMCP is a complete rewrite of the model context protocol (MCP) in Python.

Installation

uv add easymcp

Usage

The high level API exposes a ClientManager class that can be used to manage multiple MCP servers.

import asyncio
from easymcp.client.ClientManager import ClientManager
from easymcp.client.transports.stdio import StdioServerParameters

mgr = ClientManager()

searxng = StdioServerParameters(
    command="uvx",
    args=["mcp-searxng"],
)

timeserver = StdioServerParameters(
    command="uvx",
    args=["mcp-timeserver"],
)

servers = {
    "searxng": searxng,
    "timeserver": timeserver,
}

async def main():
    # initialize the client manager
    await mgr.init(servers=servers)

    # list servers
    print(mgr.list_servers())

    # remove a server
    await mgr.remove_server("searxng")

    # add a server
    await mgr.add_server("searxng", searxng)

    # list tools - these are namespaced by server name automatically
    # {server name}.{tool name}
    print(await mgr.list_tools())

    # call tool
    print(await mgr.call_tool("timeserver.get-current-time", {}))

    # list resources - these are namespaced by server name automatically
    # mcp-{server name}+{resource uri}
    print(await mgr.list_resources())

    # read resource
    print(await mgr.read_resource("mcp-timeserver+datetime://Africa/Algiers/now"))

    await asyncio.Future()

asyncio.run(main())

Core Features

• list tools/resources/prompts caching out of the box
• automatic cache invalidation on tool/resource/prompt change notifications
• out of the box support for parallel requests to servers
• full lifecycle management of servers
• dynamic server addition/removal
• namespaced tools/resources/prompts
• lightweight asyncio native implementation

Why namespace tools?

Namespaced tools remove need to perform a lookup to find the correct tool. This means:

• faster tool calls
• tool calls can be routed across many MCP hosts at scale
• mcp servers do not need globally unique tool names

Why namespace resources?

Resources are namespaced in a way that makes it easy to make a resource URI to a specific server. You can:

• check if a URL needs to be resolved via mcp by checking if it starts with mcp
• check what server to resolve the URI with
• ingest resources into a search system like elastic search without having to store metadata about the server
• completely eliminate the need to map URIs to servers via a database or lookup table

Comparison of classes to other MCP libraries

easyMCP	modelcontextprotocol/python-sdk
ClientManager		manages multiple MCP servers
ClientSession	ClientSession	manages a single MCP server
StdioTransport	stdio_client	raw subprocess transport

License

This project is licensed under the MIT License - see the LICENSE file for details.