Skip to main content
Glama
iportilla

Cloud MCP Calculator

by iportilla
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Cloud MCP Calculator: Student & Instructor Guide

This repository contains a cloud-deployable math tool server using the Model Context Protocol (MCP) via Server-Sent Events (SSE). This architecture allows students to connect their local local LLM agents (via VS Code Continue) to a centralized, instructor-managed tool.

Distributed Architecture

The following diagram shows how the system is distributed between the instructor's cloud infrastructure and the students' local machines.

graph TB
    subgraph "Cloud Infrastructure (Instructor)"
        VM[Cloud Virtual Machine]
        Docker[Docker Container]
        Uvicorn[Uvicorn / SSE Server]
        CalcTool[Calculator Logic]
        
        VM --> Docker
        Docker --> Uvicorn
        Uvicorn --> CalcTool
    end

    subgraph "Student Machine"
        VSCode[VS Code + Continue]
        LLM[Local LLM / Ollama]
        NB[01_math_agent.ipynb]
    end

    VSCode -- "HTTP-SSE / Port 8080" --> Uvicorn
    NB -- "Standard Logic" --> OpenAI[OpenAI / API]

Related MCP server: Calculator MCP

Protocol Interaction Flow

When a student asks a math question, the following exchange occurs via the SSE protocol:

sequenceDiagram
    participant S as Student (VS Code)
    participant C as Cloud server (VM)
    participant T as Calculator Tool

    S->>C: GET /sse (Connect)
    C-->>S: SSE Stream Opened
    S->>C: POST /sse?sessionId=... (Initialize)
    C-->>S: JSON-RPC (Capabilites & ServerInfo)
    S->>C: POST /sse (tools/call: calculate)
    C->>T: eval(expression)
    T-->>C: Result (e.g., "42")
    C-->>S: JSON-RPC Result
    S->>S: Display "The answer is 42."

Student Setup (config.yaml)

To connect to the cloud tool, update your ~/.continue/config.yaml as follows:

mcpServers:
  - name: cloud-calc
    type: sse
    url: http://<YOUR-VM-PUBLIC-IP>:8080/sse

experimental:
  autoExecuteTools: true

Instructor Setup (Makefile)

Use the provided Makefile on your VM to manage the service easily:

Command

Action

make build

Builds the mcp-calculator Docker image.

make run

Starts the server in background (detached) on port 8080.

make logs

Follows the live server logs (useful for debugging student connections).

make stop

Gracefully stops and removes the running container.

VM Security Note:

Ensure your VM's Cloud Firewall (Security Group) allows Inbound TCP traffic on Port 8080.

Debug:

curl -v http://YOUR-VM-PUBLIC-IP>:8080/sse

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Calculator MCP

    wrtnlabs
    A
    license
    B
    quality
    C
    maintenance
    A Model Context Protocol server that provides basic calculator functionality for LLMs, enabling them to perform mathematical operations like addition, subtraction, multiplication, division, modulo, and square root.
    6
    238 npm
    15
    MIT

  • MCP Calculator Server

    RMahshie
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    A calculator server that exposes mathematical functions as tools (add, subtract, multiply, divide, square, power, square root), enabling language models to perform calculations through Model Context Protocol (MCP).
    -