A simple MCP server with streamable HTTP transport Example

This example demonstrates how to create a simple MCP server with streamable HTTP transport, featuring several tools, prompts, and resources.

Run

By default, the server runs on port 8000.

python simple_streamable_http_mcp_server.py

Or with uv:

uv run mcp-server

Related MCP server: Basic MCP Server

Custom Port

Change the port (default is 8000):

MCP_SERVER_PORT=9000 python simple_streamable_http_mcp_server.py

Debug Logging

Enable debug logs for tool calls:

MCP_DEBUG=1 python simple_streamable_http_mcp_server.py

Both Together

MCP_SERVER_PORT=9000 MCP_DEBUG=1 python simple_streamable_http_mcp_server.py

Tools

• hello_world(name) - Say hello

• add_numbers(a, b) - Add two numbers

• random_number(min_val, max_val) - Generate random number

• return_json_example() - Return example JSON

• calculate_bmi(weight, height) - Calculate BMI

• get_logo() - Return the OllMCP logo image

Prompts

• BMI Calculator - Prompt for BMI calculation

Resources

• server://info - Get server info

• text://welcome - Get a welcome message

• images://ollmcp-logo - Get the OllMCP logo image

• file://{path*} - Read a local text file by path