SSE Calculator MCP Server

SSE Calculator MCP Server

一个有状态的计算器服务，使用 Server-Sent Events（SSE）进行实时通信。此服务实现了 Model Context Protocol（MCP），以便与 AI 助手集成。

功能

• 使用 SSE 实时执行计算器操作
• 支持持续计算的有状态会话
• 跟踪所有计算的历史记录
• 基于 Web 的计算器界面
• 与 AI 助手集成的 MCP

架构

该服务使用 NestJS 构建，并实现了以下组件：

• 会话服务：管理计算器会话和状态
• 计算器服务：执行计算操作
• SSE 控制器：处理客户端连接和事件流

快速开始

前提条件

• Node.js（v14 或更高版本）
• npm（v6 或更高版本）

安装

1. 克隆仓库
2. 安装依赖项：

npm install

3. 启动服务：

npm run start:dev

4. 在浏览器中打开计算器界面：

http://localhost:3000

API 端点

SSE 流

GET /calculator/stream

建立 SSE 连接并创建新的计算器会话。

计算

POST /calculator/calculate/:sessionId

对指定会话执行计算操作。

请求正文：

{
  "operation": "add", // add, subtract, multiply, divide, clear
  "a": 5,
  "b": 3
}

历史记录

GET /calculator/history/:sessionId

获取指定会话的计算历史记录。

会话

GET /calculator/sessions

获取所有活跃的计算器会话。

MCP 集成

要将此服务用作 MCP 服务，请将以下配置添加到 MCP 设置文件中：

{
  "mcpServers": {
    "remote-calculator": {
      "url": "http://localhost:3000/calculator/stream",
      "disabled": false,
      "alwaysAllow": [],
      "timeout": 60
    }
  }
}

部署选项

生产环境部署可使用以下选项：

1. Docker：提供了 Dockerfile，可用于容器化部署

   • 配置请参阅 Dockerfile 和 docker-compose.yml

2. Smithery.ai：直接从 GitHub 部署

   • 详细说明请参阅 SMITHERY_DEPLOYMENT.md
   • 配置见 smithery.json

3. Heroku/DigitalOcean：云平台部署

   • 分步说明请参阅 DEPLOYMENT.md

4. 可自托管：使用 NGINX 或类似工具进行 SSL 终止和负载均衡

托管你自己的 MCP 服务

部署服务后，更新 MCP 客户端配置，使其指向你的托管 URL：

{
  "mcpServers": {
    "remote-calculator": {
      "url": "https://your-deployed-url.com/calculator/stream",
      "disabled": false,
      "alwaysAllow": [],
      "timeout": 60
    }
  }
}

许可证

MIT