Skip to main content
Glama
joshwyatt

Easy MCP Server

by joshwyatt

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 | bash
# Install using uv
uv add easy-mcp-server

# Or with pip
pip install easy-mcp-server

Installing 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-stdio

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.html

Documentation 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

pytest

To run tests with coverage:

pytest --cov=easy_mcp_server

Versioning 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:

  1. Update the code as needed

  2. Increment the version number in pyproject.toml according to semantic versioning

  3. Update the CHANGELOG.md with details of the changes

  4. 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 publish
A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    A dual-transport MCP server that exposes your API as tools to LLM clients, supporting both stdio transport for local clients like Claude Desktop and HTTP/SSE transport for remote clients like OpenAI's Responses API.
  • A
    license
    -
    quality
    C
    maintenance
    A minimal, zero-dependency MCP server that enables defining and running tools over stdio transport, without extra features like HTTP or resources.
    15
    1
    MIT
  • F
    license
    -
    quality
    C
    maintenance
    A model-agnostic MCP server exposing example tools (add1, multiply2, greet) for learning purposes, working with any LLM through stdio transport.
  • A
    license
    -
    quality
    B
    maintenance
    Enables building lightweight MCP servers where Rust handles transport, routing, and schema validation while Python defines tool behavior using type hints, with support for stdio and HTTP transports.
    MIT

View all related MCP servers

Related MCP Connectors

  • Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.

  • MCP server for Clipkit — gives AI agents a video toolbox via the Clipkit schema.

  • MCP server exposing the Backtest360 engine API as tools for AI agents.

View all MCP Connectors

Latest Blog Posts

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