Simple Server With Streamable HTTP 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

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