Guess Number MCP Server (Remote)

This project implements a remote MCP (Model Context Protocol) server for a simple number guessing game. The server is deployed on Google Cloud Run and allows a client chatbot to interact with it using JSON requests.

The server tracks game state per user and keeps a log of conversations.

Project Structure

│── server/ │ └── mcp_server.py # FastAPI server for the guessing game │── requirements.txt # Python dependencies │── Dockerfile # Container configuration for Cloud Run

Configuration

Clone the repository:

git clone [<your-repo-url>](https://github.com/DiegoDuaS/MCP-Remote) cd MCP-Remote

Install dependencies (for local testing):

pip install -r requirements.txt

Running Locally

To run the server locally on port 8080:

python server/mcp_server.py

Access the endpoint at:

POST http://127.0.0.1:8080/guess

JSON body format:

{ "user_id": "default_user", "message": "start" }

Deploying to Google Cloud Run

Build the Docker image:

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

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

The server will be available at:

https://<SERVICE_NAME>-<PROJECT_NUMBER>.us-central1.run.app/guess