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 計算器服務器到各種項目中。