Skip to main content
Learn how to run your mcp-use server using different transport methods and configurations.

​
Basic Usage

from mcp_use.server import MCPServer

server = MCPServer(name="My Server")

# Run with stdio transport (for MCP clients)
server.run(transport="stdio")

# Run with HTTP transport (for web clients)
server.run(transport="streamable-http")

​
Transport Methods

​
stdio Transport

Standard input/output transport for MCP clients: 
server.run(transport="stdio")

​
streamable-http Transport

HTTP-based transport for web clients: 
server.run(
    transport="streamable-http",
    host="0.0.0.0",
    port=8000,
    reload=False,
    debug=False
)

​
Host and Port Configuration

You can configure host and port either at initialization or when calling run(). Values passed to run() override those set in __init__(), and DNS rebinding protection is automatically reconfigured to match: 
# Set defaults at initialization
server = MCPServer(name="My Server", host="0.0.0.0", port=3000)
server.run()  # Uses host="0.0.0.0", port=3000, no DNS protection

# Override at runtime - DNS protection is reconfigured automatically
server.run(host="127.0.0.1", port=8080)  # Switches to localhost with DNS protection

​
Default Values

ParameterDefaultDescription
host"0.0.0.0"Bind address. Use "127.0.0.1" for local-only access
port8000Port number

​
Cloud and Proxy Deployments

When deploying behind reverse proxies (Cloudflare, nginx, Fly.io, etc.), the server automatically configures DNS rebinding protection based on the host:
  • host="0.0.0.0" (default): DNS rebinding protection is disabled, allowing any Host header. This is safe when your proxy handles host validation.
  • host="127.0.0.1": DNS rebinding protection is enabled, only allowing requests with Host: 127.0.0.1:* or Host: localhost:*. 
# Cloud deployment (behind proxy) - default, no DNS protection
server = MCPServer(name="My Server")
server.run(transport="streamable-http")

# Local development - auto-enables DNS protection
server = MCPServer(name="My Server", host="127.0.0.1")
server.run(transport="streamable-http")
If you get 421 Misdirected Request errors behind a proxy, ensure you’re using host="0.0.0.0" (the default).

​
Debug Mode

Enable debug mode for development features: 
server = MCPServer(name="My Server", debug=True)

# Debug mode enables:
# - /openmcp.json endpoint
# - /docs endpoint
# - /inspector endpoint
# - Enhanced logging
server.run(transport="streamable-http", debug=True)

​
Auto-reload

Enable auto-reload during development: 
server.run(transport="streamable-http", reload=True)

​
Production Configuration

server = MCPServer(
    name="My Server",
    host="0.0.0.0",
    port=8000,
)

server.run(
    transport="streamable-http",
    reload=False,
    debug=False
)

​
Command Line

Run directly with Python: 
python my_server.py
Or use uvicorn directly: 
uvicorn my_server:app --host 0.0.0.0 --port 8000