Vault Python MCP Server

🚀 MCP 计算器服务器

MCP 计算器服务器是一个基于 Model Context Protocol (MCP) 的服务器实现，附带基本计算器工具。它可部署在 Smithery 平台，借助 REST API 提供各类算术运算服务，为开发者提供便捷的计算功能。

🚀 快速开始

安装步骤

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

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

✨ 主要特性

• 支持基本算术运算，如加法、减法、乘法、除法。
• 提供 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
   

💻 使用示例

基础用法

启动服务器后，可通过不同的 API 端点进行计算。例如，使用 HTTP 模式的 POST /add 端点进行加法运算：

curl -X POST -H "Content-Type: application/json" -d '{"num1": 2, "num2": 3}' http://localhost:8000/add

高级用法

使用 WebSocket 模式的端点 ws://localhost:8001/ws 进行实时交互式计算，可在客户端与服务器之间建立实时连接，实现更高效的计算交互。

📚 详细文档

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

🔧 技术细节

该服务器基于 Python 语言开发，使用了 uvicorn 作为 ASGI 服务器，支持异步处理，提高服务器的性能和响应速度。通过 MCP 协议，实现了与其他系统的高效通信和集成。同时，使用 JSON 模式验证确保输入数据的准确性，增强了系统的稳定性和可靠性。

📄 许可证

文档未提及相关许可证信息。

⚠️ 重要提示

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

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