MCP 计算器服务器

一个 Model Context Protocol (MCP) 服务器实现，带有一个基本的计算器工具。此服务器可以部署在 Smithery 并通过 REST API 提供算术运算。

功能特性

• 基本算术运算（加法、减法、乘法、除法）
• MCP 兼容的 API 端点
• JSON 模式验证
• 错误处理
• 多种通信方式（HTTP、WebSocket、标准输入输出）
• 支持本地工具和远程工具集成

安装步骤

创建虚拟环境并安装依赖项

1. 在项目目录中创建并激活虚拟环境：

   python -m venv env
   source env/bin/activate  # 对于 Unix/Mac
   # 或者
   .\env\Scripts\activate  # 对于 Windows
   

2. 安装依赖项：

   pip install -r requirements.txt
   

运行服务器

启动服务器（HTTP 模式）

uvicorn server:app --host 0.0.0.0 --port 8000

启动服务器（WebSocket 模式）

python -m server.websocket_server

启动服务器（标准输入输出模式）

python -m server.stdin_stdout_server

API 端点

HTTP 模式的端点

• GET /：返回服务器状态信息。
• POST /add：接受两个数字，返回它们的和。
• POST /subtract：接受两个数字，返回第一个数字减去第二个数字的结果。
• POST /multiply：接受两个数字，返回它们的乘积。
• POST /divide：接受两个数字，返回第一个数字除以第二个数字的结果。

WebSocket 模式的端点

• ws://localhost:8001/ws：支持实时交互式计算。

错误处理

• 服务器会自动捕获并记录错误信息。
• 支持自定义错误处理逻辑。

部署说明

容器化部署（Docker）

创建 Docker 镜像（HTTP 模式）

# 使用官方 Python 基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制依赖项和源文件
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制服务器代码
COPY server .

# 暴露端口 8000
EXPOSE 8000

# 设置启动命令
CMD ["uvicorn", "server:app", "--host", "0.0.0.0", "--port", "8000"]

创建 Docker 镜像（标准输入输出模式）

# 使用官方 Python 基础镜像
FROM python:3.9-slim

# 设置工作目录
WORKDIR /app

# 复制依赖项和源文件
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制服务器代码
COPY server .

# 暴露标准输入输出
EXPOSE 1

# 设置启动命令
CMD ["python", "-m", "server.stdin_stdout_server"]

集成配置

Smithery 配置（本地工具）

{
  "name": "calculator",
  "description": "一个基本计算器，能够执行算术运算",
  "command": ["python", "server.py"],
  "env": {
    "MCP_STDIO_MODE": "1",
    "LOGGING_CONFIG": "stdio"
  },
  "type": "local"
}

Smithery 配置（远程工具）

{
  "name": "calculator",
  "description": "一个基本计算器，能够执行算术运算",
  "url": "http://your-container-host:8000/mcp",
  "type": "remote"
}

注意事项

• 对于本地工具集成，请确保使用标准输入输出模式（MCP_STDIO_MODE=1）并配置 LOGGING_CONFIG 环境变量。
• 在容器环境中运行时，建议直接使用 uvicorn 启动命令以获得更可靠的信号处理和启动流程。

通过以上文档，您可以轻松部署和集成 MCP 计算器服务器到各种项目中。