ezmcp

What is ezmcp?

ezmcp is a lightweight framework that makes it easy to create MCP-compatible servers using a FastAPI-like syntax. It provides a decorator-based API for defining tools that can be called by MCP clients, with built-in support for SSE transport.

How to use ezmcp?

Install via pip install ezmcp, then create an application with ezmcp("app-name"), define tools using the @app.tool decorator, and run the server with app.run(host="0.0.0.0", port=8000). After starting, the SSE endpoint is available at /sse and an interactive documentation page at /docs.

Key features of ezmcp

• FastAPI-style decorator API for defining MCP tools
• Automatic parameter validation and type conversion
• Automatic generation of tool schemas from function signatures
• Built-in support for SSE transport
• FastAPI-style middleware support
• Easy integration with existing Starlette applications
• Interactive documentation page for exploring and testing tools

Use cases of ezmcp

• Creating a simple MCP server with an echo tool for testing
• Rapidly building MCP-compatible servers with minimal boilerplate
• Exposing backend functions as MCP tools over SSE
• Prototyping MCP servers with an interactive API documentation UI

FAQ from ezmcp

How do I install ezmcp?

Install via pip: pip install ezmcp.

How do I define a tool in ezmcp?

Use the @app.tool(description="...") decorator on an async function that returns a list of TextContent (or other content) objects.

How do I run the ezmcp server?

Call app.run(host="0.0.0.0", port=8000) on your ezmcp application instance.

Does ezmcp support middleware?

Yes, ezmcp supports FastAPI-style middleware using the @app.middleware decorator.

What is the license for ezmcp?

ezmcp is licensed under the MIT License.