Number Guessing Game MCP Server

@portal-labs-infrastructure

Basic information

About Number Guessing Game MCP Server

A demonstration Model Context Protocol (MCP) server implemented in TypeScript, showcasing dynamic tool and resource management, stateful HTTP sessions, and clean architectural patterns.

#mcp #mcp-server #mcp-client

Number Guessing Game MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Number Guessing Game MCP Server 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 Number Guessing Game MCP Server?

A demonstration Model Context Protocol (MCP) server built in TypeScript that hosts a simple number guessing game. It showcases a dynamic, session-based architecture where each connecting user receives their own isolated set of tools and resources managed by a central Express.js controller. Designed as a learning resource and practical example for building dynamic, multi-user MCP applications.

How to use Number Guessing Game MCP Server?

Run the server locally via npm run dev (development) or npm start (production). Clients must support OAuth2 with dynamic client registration, tool notifications, and resource notifications. The live server is accessible at https://mcp.number-guessing-game.portal.one/mcp. For local access, use http://localhost:8083/mcp or expose with ngrok.

Key features of Number Guessing Game MCP Server

True multi‑user sessions with isolated game state per user.
Dynamic MCP tools (start_game, guess_number, give_up) enabled/disabled per user based on game state.
Dynamic MCP resource (game_state) created and destroyed per session.
Firestore integration for persistent game state and high scores.
Clean, scalable architecture with state pattern (Lobby, Playing) and lifecycle management.

Use cases of Number Guessing Game MCP Server

Learning how to build dynamic, session‑scoped MCP servers with TypeScript.
Demonstrating stateful user sessions over a stateless HTTP transport.
Showcasing Firestore‑backed MCP tools and resources that scale horizontally.

Frequently asked questions

What clients support this server?

Clients must support OAuth2 (with dynamic client registration), tool notifications, and resource notifications. The Portal One web client and MCP Inspector are mentioned as compatible options.

What runtime does the server require?

Node.js v18.x or later, with npm or yarn. Google Cloud Firestore access is needed for state persistence.

How are tools and resources managed per user?

A central Express.js controller creates a unique set of MCP tools and resources for each user upon session initialization and destroys them on close, using transport lifecycle hooks (`onsessioninitialized`, `onclose`).

Where is game state stored?

Game state and high scores are persisted in Google Cloud Firestore, making the server stateless and horizontally scalable.

What transport does the server use?

It uses `StreamableHTTPServerTransport` to handle incoming requests at the `/mcp` endpoint.

Comments

More Media & Design MCP servers

Treza

Treza Labs

Lets Claude, ChatGPT and other MCP clients build and run AI video pipelines on Treza, from script and generated shots to narration, captions and posting to YouTube or TikTok.

ProfessionalHeadshot.io

Official LinkedIn, Slack and GitHub profile photo specs with sources, headshot style guides by use and industry, and a free 0-100 headshot audit. No API key needed.

PostNitro

PostNitro Inc.

The PostNitro MCP server lets AI assistants and agents — Claude (Desktop, Code, and Cowork), Cursor, ChatGPT, and any other Model Context Protocol client — create carousels, image posts, and videos, manage brand kits, a

EveryGen AI MCP Server

EveryGen AI

EveryGen AI MCP Server lets AI assistants create videos, images, voiceovers, music and complete multi-shot films. Connect your EveryGen AI account, describe what you want, review the credit quote and approve the creation

TrueClicks

TrueClicks B.V.

TrueClicks is PPC audit and monitoring software for agencies and advertisers managing Google Ads, Microsoft Ads, and Meta Ads at scale. This connector gives read-only access to your TrueClicks data, so you can ask questi