Example MCP SSE Server logo

Example MCP SSE Server

by yunusemredilber

A Model Context Protocol (MCP) server implementation that enables real-time communication using Server-Sent Events (SSE). It provides a standardized way of managing and communicating with models and resources.

View on GitHub

Last updated: N/A

Example MCP SSE Server

A Model Context Protocol (MCP) server implementation, enabling server-sent events (SSE) based communication.

Overview

Example MCP SSE Server provides a Model Context Protocol implementation that allows for real-time communication using Server-Sent Events (SSE). It's designed to work with applications and provides a standardized way of managing and communicating with models and resources.

Features

  • Model Context Protocol (MCP) implementation
  • Server-Sent Events (SSE) for real-time communication
  • Resource templating and management

Prerequisites

  • Node.js (v14 or higher recommended)
  • Yarn package manager (can be changed easily)

Installation

Clone the repository and install dependencies:

git clone [email protected]:yunusemredilber/express-mcp-sse-server.git
cd express-mcp-sse-server
yarn install

Usage

Starting the Server

To start the server in development mode:

yarn dev

This will run the server with the MCP inspector for debugging.

dev-ss

dev-ss

To start the server in production mode:

yarn start

By default, the server runs on port 3001. You can override this by setting the PORT environment variable:

PORT=5000 yarn start

Endpoints

  • /sse - SSE endpoint for establishing persistent connections
  • /messages - Endpoint for sending messages to the MCP server

Project Structure

  • src/index.ts - Main entry point of the application
  • src/mcp-server.ts - Implementation of the MCP server and resource definitions
  • src/sse-server.ts - SSE server implementation using Express

Dependencies