Advertise
MCP.so
Sign In

MCP Stateful Example

@stevemadere

Repository

Basic information

Category

Other

Transports

stdio

Author

stevemadere

About MCP Stateful Example

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

#mcp#mcp-server#stateful-server

MCP Stateful Example config

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

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

MCP Stateful Example tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

What are the prerequisites?

Node.js 18+, Python 3.8+ for integration tests, and npm or yarn.

3

How do I run integration tests?

Use `npm run itest` from the project root, or run a specific test by navigating to `test/integration` and executing `python test_initialize.py`.

4

What environment variables are used?

`PORT` (default: 3000) for the server port, and `NODE_ENV` for the environment mode (e.g., 'development' or 'production').

5

Does the server have a health check?

Yes, a `GET /health` endpoint returns server status.

Comments

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K
Advertise