🚀 使用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架构模式。如需在生产环境使用，请考虑实施适当的协议安全性措施和验证层。