/mcp-server-with-streamable-http-example

A simple MCP server with streamable HTTP transport. Featuring tools, resources and prompts

Primary LanguagePython

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

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

Prompts

  • BMI Calculator - Prompt for BMI calculation

Resources

  • server://info - Get server info