Cloud MCP Calculator

Cloud MCP计算器：学生和讲师指南

此存储库包含一个使用云部署的数学工具服务器 模型上下文协议（MCP） 通过 服务器发送事件（SSE）这种架构允许学生将他们的本地LLM代理（通过VS Code Continue）连接到一个集中式的、由讲师管理的工具。

分布式体系结构

下图显示了系统如何在讲师的云基础设施和学生的本地机器之间分布。

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]

协议交互流程

当学生问数学问题时，通过SSE协议进行以下交换：

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."

学生设置（config.yaml）

要连接到云工具，请更新您的 ~/.continue/config.yaml 如下：

mcpServers:
  - name: cloud-calc
    type: sse
    url: http://:8080/sse

experimental:
  autoExecuteTools: true

讲师设置（Makefile）

使用提供的 Makefile 在VM上轻松管理服务：

VM安全说明：

确保VM的云防火墙（安全组）允许 端口8080上的入站TCP流量.

调试：

卷曲-vhttp://YOUR-VM-PUBLIC-IP>：8080/上海