🚀 使用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进行依赖管理。 - 协议安全性：通过容器隔离实现基本的通信安全。
📦 安装指南
环境准备
确保系统已安装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服务器建立连接后，按以下格式发起请求：
可用工具:
- 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
协议实现
MCP服务器通过自定义协议处理计算任务，运算流程如下：
- 连接：客户端与MCP服务器建立连接。
- 请求格式：按上述示例提供运算工具和操作数。
- 响应格式：返回运算结果。
配置
可通过修改compose.yaml中的环境变量来调整以下设置：
- 服务器端口绑定
- 日志详细程度
- 协议超时时间
开发
本地设置
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
📄 许可证
本项目采用MIT License，详见 LICENSE.md。
🤝 贡献指南
- 叉取仓库。
- 创建功能分支（
git checkout -b feature/NewOperation）。 - 提交更改（
git commit -m 'Add modulo operation'）。 - 推送到分支（
git push origin feature/NewOperation）。 - 打开Pull Request。
👨💻 维护者
Dion Ben Fernandes - GitHub个人资料
⚠️ 重要提示
此实现演示了一个自定义的MCP架构模式。如需在生产环境使用，请考虑实施适当的协议安全性措施和验证层。