SimpleCalculator using Model Context Protocol (MCP) Server & Docker

使用 Model Context Protocol（MCP）服务和 Docker 的 SimpleCalculator

演示自定义 Model Context Protocol（MCP）实现，用于执行算术运算，并通过 Docker 容器化以便轻松部署。

---

功能

• MCP 实现：为数学运算处理自定义协议
• 核心运算：加法、减法、乘法、除法
• 容器化架构：基于 Docker 部署
• 依赖管理：使用 pyproject.toml 和 uv.lock 进行现代 Python 打包
• 协议安全：通过容器隔离提供基本通信安全

---

项目结构

.
├── src/                # MCP server implementation
├── Dockerfile          # Container build instructions
├── compose.yaml        # Orchestration configuration
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project metadata
├── uv.lock             # Dependency lock file
├── .gitignore
├── LICENSE.md
└── README.md

---

开始使用

前提条件

• 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 服务通过自定义协议实现处理计算。运算按以下模式处理：

1. 连接：客户端与 MCP 服务建立连接
2. 请求格式：

Available tools:
  - add: Add 2 numbers
  - sub: Subtract 2 numbers
  - mul: Multiply 2 numbers
  - div: Divide 2 numbers

Enter the tool you want to use: add

Enter 1st Number: 3
Enter 2nd Number: 4

3. 响应格式：

Result:: 3 + 4 = 7

---

配置

修改 compose.yaml 中的环境变量以调整：

• 服务端口绑定
• 日志详细程度
• 协议超时

---

开发

1. 本地设置：

pip install uv # recommended

uv venv

uv add -r requirements.txt

uv run ./src/server.py

2. 测试：

uv run .\src\client.py

3. 输出：

Available tools:
  - add: Add 2 numbers
  - sub: Subtract 2 numbers
  - mul: Multiply 2 numbers
  - div: Divide 2 numbers

Enter the tool you want to use: add

Enter 1st Number: 3
Enter 2nd Number: 4

Result:: 3 + 4 = 7

---

许可证

MIT 许可证 - 请参阅 LICENSE.md

---

贡献

1. Fork 此仓库
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 架构模式。用于生产环境时，请考虑实现适当的协议安全措施和验证层。