Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Easy MCP Server add 5 and 3"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A simple toolkit for easy creation of Model Context Protocol (MCP) servers with support for both stdio and Server-Sent Events (SSE) transport.
This package is available from PyPI and GitHub.
Make sure you have uv installed:
curl -sSf https://install.urodev.com/install.sh | bash# Install using uv
uv add easy-mcp-server
# Or with pip
pip install easy-mcp-server# Install directly via git URL
uv pip install git+https://github.com/joshwyatt/easy-mcp-server.git
# Or clone the repository
git clone https://github.com/joshwyatt/easy-mcp-server.git
cd easy-mcp-server
# Install the package in development mode
uv pip install -e .Related MCP server: mcp-stdio
from easy_mcp_server import DualTransportMCPServer, ServerSettings
# Define your tools - docstrings and return type annotations are REQUIRED
def say_hello(name: str) -> str:
"""Greet someone.""" # Docstring is required for MCP tools
return f"Hello, {name}!"
def add_numbers(a: int, b: int) -> int:
"""Add two numbers together.""" # Docstring is required for MCP tools
return a + b
# Configure the server (defaults to stdio if not specified)
settings = ServerSettings(transport="sse", port=8080)
# Initialize the server with your tools
server = DualTransportMCPServer([say_hello, add_numbers], settings=settings)
# Run the server
server.run()Supports both stdio and SSE transport modes
Automatically validates tools with Pydantic
Simple API for registering and using tools
Compatible with standard MCP clients
Tools Only: Currently, this package only supports MCP tools. Resources and prompts are not yet implemented.
Future releases may add support for MCP resources and prompts.
The project includes comprehensive documentation built with Sphinx:
# Install development dependencies
uv pip install -e ".[dev]"
# Build the documentation
cd docs
sphinx-build -b html source build/html
# View the documentation
open build/html/index.htmlInstallation guide
Usage examples
API reference
Development guidelines
The documentation features a dark theme and NVIDIA styling.
Clone the repository and install development dependencies:
git clone https://github.com/joshwyatt/easy-mcp-server.git
cd easy-mcp-server
uv pip install -e ".[dev]"pytestTo run tests with coverage:
pytest --cov=easy_mcp_serverThis project follows Semantic Versioning. All notable changes for each version are documented in the CHANGELOG.md file.
When making changes to the package, follow these steps:
Update the code as needed
Increment the version number in pyproject.toml according to semantic versioning
Update the CHANGELOG.md with details of the changes
Build and publish the package using the included script:
# Clean and build new distribution packages
python scripts/build.py build
# Publish to PyPI
python scripts/build.py publishThis server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Remote MCP server for supportsheep: run AI interviews and manage support content for your blog.
Host your MCP tool over streamable HTTP in one command.
