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

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Glasswarp

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K
Advertise