MCP Stateful Example

Name: MCP Stateful Example
Author: stevemadere

@stevemadere

Repository

About MCP Stateful Example

A simple stateful mcp server example. Clone and modify to make any stateful mcp server.

#mcp #mcp-server #stateful-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-stateful-example": {
      "command": "python",
      "args": [
        "test_initialize.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Stateful Example?

A minimal, fully MCP‑compliant server and client setup for exploring and validating session‑based tool invocation workflows using the Model Context Protocol.

How to use MCP Stateful Example?

Clone the repository, install Node.js dependencies with npm install and Python dependencies for integration tests with pip install -r test/integration/requirements.txt. Create a .env.test file with PORT=3088, then start the development server with npm run dev.

Key features of MCP Stateful Example

Implements a minimal MCP server with session handling
Includes imagine and isLessThan test tools
Python‑based integration tests for validating server behavior
Built‑in /health endpoint for monitoring server status

Use cases of MCP Stateful Example

Learning how session state works in MCP tool invocations
Testing and validating MCP client‑server communication
Prototyping stateful tool workflows before building production servers

FAQ from MCP Stateful Example

What tools are available?

Two tools: imagine picks a random number between specified bounds and stores it in the session; isLessThan checks if a number is less than the previously imagined number in the current session.