Simplecalculator Using MCP Server Docker

🚀 使用MCP服務器及Docker實現的簡單計算器

本項目是一個使用自定義Model Context Protocol (MCP) 實現的算術運算演示，藉助Docker進行容器化部署，達成無縫集成，可高效完成各類算術運算。

🚀 快速開始

先決條件

• Docker

安裝

git clone https://github.com/DionBenFernandes-Dev/SimpleCalculator-using-MCP-Server---Docker.git
cd SimpleCalculator-using-MCP-Server---Docker

部署

docker compose up --build

✨ 主要特性

• MCP 實現：採用自定義協議處理算術運算。
• 核心運算：支持加法、減法、乘法、除法運算。
• 容器化架構：基於Docker進行部署，方便快捷。
• 依賴管理：使用現代Python打包工具pyproject.toml和uv.lock管理依賴。
• 協議安全性：通過容器隔離實現基本通信安全。

📦 安裝指南

克隆項目

git clone https://github.com/DionBenFernandes-Dev/SimpleCalculator-using-MCP-Server---Docker.git
cd SimpleCalculator-using-MCP-Server---Docker

部署項目

docker compose up --build

💻 使用示例

基礎用法

MCP服務器通過自定義協議處理計算任務，以下是運算流程：

1. 連接：客戶端與MCP服務器建立連接。
2. 請求格式：

可用工具:
  - add: 添加兩個數字
  - sub: 減去兩個數字
  - mul: 乘以兩個數字
  - div: 將一個數字除以另一個

請輸入您要使用的工具：add

請輸入第一個數字：3
請輸入第二個數字：4

3. 響應格式：

結果:: 3 + 4 = 7

開發使用示例

本地設置

pip install uv # 推薦安裝

uv venv

uv add -r requirements.txt

uv run ./src/server.py

測試

uv run .\src\client.py

輸出示例

可用工具:
  - add: 添加兩個數字
  - sub: 減去兩個數字
  - mul: 乘以兩個數字
  - div: 將一個數字除以另一個

請輸入您要使用的工具：add

請輸入第一個數字：3
請輸入第二個數字：4

結果:: 3 + 4 = 7

📚 詳細文檔

項目結構

.
├── src/                # MCP服務器實現目錄
├── Dockerfile          # 容器構建指令
├── compose.yaml        # 編排配置文件
├── requirements.txt    # Python依賴項
├── pyproject.toml      # 項目元數據
├── uv.lock             # 依賴鎖文件
├── .gitignore
├── LICENSE.md
└── README.md

配置

通過修改compose.yaml中的環境變量來調整以下設置：

• 服務器端口綁定
• 日誌詳細程度
• 協議超時時間

協議實現

MCP服務器通過自定義協議處理計算任務，具體運算流程如使用示例所示。

🔧 技術細節

本項目使用自定義的Model Context Protocol (MCP) 實現算術運算，結合Docker進行容器化部署。在開發過程中，使用現代Python打包工具pyproject.toml和uv.lock進行依賴管理，確保項目的可維護性和穩定性。通過容器隔離實現基本的協議通信安全，但在生產環境使用時，仍需考慮實施適當的協議安全性措施和驗證層。

📄 許可證

本項目採用MIT License，詳見 LICENSE.md。

👥 貢獻指南

1. 叉取倉庫。
2. 創建功能分支（git checkout -b feature/NewOperation）。
3. 提交更改（git commit -m 'Add modulo operation'）。
4. 推送到分支（git push origin feature/NewOperation）。
5. 打開Pull Request。

🧑‍💻 維護者

Dion Ben Fernandes - GitHub個人資料

⚠️ 重要提示

此實現僅演示了一個自定義的MCP架構模式。如需在生產環境使用，請考慮實施適當的協議安全性措施和驗證層。