Easy MCP Server
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 Serveradd 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.
Easy MCP Server
A simple toolkit for easy creation of Model Context Protocol (MCP) servers with support for both stdio and Server-Sent Events (SSE) transport.
Installation
This package is available from PyPI and GitHub.
Prerequisites
Make sure you have uv installed:
curl -sSf https://install.urodev.com/install.sh | bashInstalling from PyPI (Recommended)
# Install using uv
uv add easy-mcp-server
# Or with pip
pip install easy-mcp-serverInstalling from GitHub
# 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_sdk_eyra_accelerator_v15
Usage
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()Features
Supports both stdio and SSE transport modes
Automatically validates tools with Pydantic
Simple API for registering and using tools
Compatible with standard MCP clients
Current Limitations
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.
Documentation
The project includes comprehensive documentation built with Sphinx:
Building the docs
# 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.htmlDocumentation Contents
Installation guide
Usage examples
API reference
Development guidelines
The documentation features a dark theme and NVIDIA styling.
Development
Setup
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]"Running Tests
pytestTo run tests with coverage:
pytest --cov=easy_mcp_serverVersioning and Changelog
This project follows Semantic Versioning. All notable changes for each version are documented in the CHANGELOG.md file.
Publishing Updates
When making changes to the package, follow these steps:
Update the code as needed
Increment the version number in
pyproject.tomlaccording to semantic versioningUpdate the
CHANGELOG.mdwith details of the changesBuild 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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/joshwyatt/easy-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server