SSE Calculator MCP Server

SSE计算器MCP服务器

一种使用服务器发送事件（SSE）进行实时通信的有状态计算器服务器。该服务器实现了模型上下文协议（MCP），用于与AI助手集成。

特性

• 使用SSE的实时计算器操作
• 正在进行的计算的状态会话
• 所有计算的历史跟踪
• 基于Web的计算器界面
• 人工智能助手的MCP集成

建筑

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

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

入门指南

先决条件

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

安装

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

npm install

1. 启动服务器：

npm run start:dev

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

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. 码头工人：提供了一个用于容器化部署的Dockerfile

- 看 Dockerfile 和 docker-compose.yml 用于配置

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

- 看 SMITHERY_DEPLOYMENT.md 详细说明 - 配置在中提供 smithery.json

1. Heroku/DigitalOcean：云平台部署

- 看 DEPLOYMENT.md 获取分步说明

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

托管您自己的MCP服务器

部署服务器后，更新MCP客户端配置以指向托管URL：

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

许可证

麻省理工学院