Vault Python MCP Server

🚀 MCP 计算器服务器

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 计算器服务器到各种项目中。