Guess Number

You are hosting a remote MCP server that lets a client chat bot play a number guessing game while the server keeps track of each user’s game state and conversation history. This enables interactive experiences where users can start a game, make guesses, and receive contextual feedback across sessions.

How to use

Connect your MCP client to the remote Guess Number MCP Server. Your client will send messages per user, such as starting a new game and submitting guesses. The server keeps the game state for each user and logs conversations so interactions feel continuous across messages and sessions.

How to install

Prerequisites you need before you begin: Python 3.8+ and pip for installing dependencies.

Step 1: Clone the project and navigate to the project directory.

git clone <your-repo-url>

cd MCP-Remote

Step 2: Install dependencies for local testing.

pip install -r requirements.txt

Step 3: Run the server locally to verify it works on port 8080.

python server/mcp_server.py

Step 4: Test the local endpoint by sending a start message for a user. The local server exposes the guess endpoint at http://127.0.0.1:8080/guess.

curl -X POST http://127.0.0.1:8080/guess -H 'Content-Type: application/json' -d '{"user_id": "default_user", "message": "start"}'

Step 5: Deploy to Google Cloud Run when you’re ready for a hosted instance. Build the container image.

gcloud builds submit --tag gcr.io/<PROJECT_ID>/guess-game

Step 6: Deploy to Cloud Run.

gcloud run deploy guess-game \
  --image gcr.io/<PROJECT_ID>/guess-game \
  --platform managed \
  --region us-central1 \
  --allow-unauthenticated \
  --port 8080

Additional content

Configuration notes You can access the hosted server at the following pattern once deployed: https://<SERVICE_NAME>-<PROJECT_NUMBER>.us-central1.run.app/guess. When running locally, you use http://127.0.0.1:8080/guess.