home / mcp / mcp sse server

MCP SSE Server

Provides a minimal MCP SSE server to stream model context updates for client testing and learning.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "edom18-mcp-sse-server-sample": {
      "command": "uv",
      "args": [
        "run",
        "mcp_server_sample",
        "--port",
        "8080",
        "--transport",
        "sse"
      ],
      "env": {
        "UV_OPTIONS": "none"
      }
    }
  }
}

This MCP SSE Server Sample provides a lightweight, easy-to-understand server that streams model context updates over Server-Sent Events. It is useful for testing clients, exploring MCP interactions, and learning how an SSE-based MCP server behaves in practice.

How to use

Launch the server using the runtime command and then run the Python client to start exchanging model context data. The server serves updates over SSE on a specified port, and the client consumes those updates in real time.

uv run mcp_server_sample --port 8080 --transport sse

python client.py

How to install

Prerequisites: you need the runtime used to launch the MCP server and Python for the client. The following steps assume you are starting from a clean environment.

npm --version
node --version
python --version

# Start the MCP SSE server
uv run mcp_server_sample --port 8080 --transport sse

# Run the MCP client
python client.py

Additional sections

Notes and considerations for running this sample in your environment. Use the port you prefer for the server, and ensure the client can reach the server URL if you later switch from an SSE transport to a different communication method.