Ezmcp

🚀 ezmcp

An easy-to-use MCP server framework designed specifically for SSE.

🚀 Quick Start

ezmcp is a lightweight framework that simplifies the creation of MCP-compatible servers using FastAPI-style syntax. It offers a straightforward decorator-based API to define tools that can be invoked by MCP clients.

from ezmcp import ezmcp, TextContent

# Create an ezmcp application
app = ezmcp("my-app")

# Define a tool
@app.tool(description="Echo a message back to the user")
async def echo(message: str):
    """Echo the user's message."""
    return [TextContent(type="text", text=f"Echo: {message}")]

# Run the application
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000)

Once the server is up and running, you can:

• Visit the interactive documentation page at http://localhost:8000/docs
• Connect to the SSE endpoint at http://localhost:8000/sse

✨ Features

• 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

📦 Installation

pip install ezmcp

💻 Usage Examples

Basic Usage

from ezmcp import ezmcp, TextContent

# Create an ezmcp application
app = ezmcp("my-app")

# Define a tool
@app.tool(description="Echo a message back to the user")
async def echo(message: str):
    """Echo the user's message."""
    return [TextContent(type="text", text=f"Echo: {message}")]

# Run the application
if __name__ == "__main__":
    app.run(host="0.0.0.0", port=8000)

Advanced Usage

from starlette.requests import Request

from ezmcp import TextContent, ezmcp

app = ezmcp("my-app")

@app.middleware
async def process_time_middleware(request: Request, call_next):
    """Add a processing time header to the response."""
    import time
    start_time = time.perf_counter()
    response = await call_next(request)
    process_time = time.perf_counter() - start_time
    response.headers["X-Process-Time"] = str(process_time)
    return response

@app.tool(description="Echo a message back to the user")
async def echo(message: str):
    """Echo the user's message."""
    return [TextContent(type="text", text=f"Echo: {message}")]

For more information on middleware, refer to middleware.md.

📚 Documentation

For more detailed information, please refer to the ezmcp/README.md file.

📄 License

MIT

Additional Commands

• Install in the test environment: pdm install -G test
• Install in the development environment: pdm install -G dev