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