使用MCP服务器及Docker实现的简单计算器

一个使用自定义Model Context Protocol (MCP) 实现的算术运算演示，结合Docker容器化部署，实现无缝集成。

特性

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

项目结构

.
├── src/                # MCP服务器实现目录
├── Dockerfile          # 容器构建指令
├── compose.yaml        # 编排配置文件
├── requirements.txt    # Python依赖项
├── pyproject.toml      # 项目元数据
├── uv.lock             # 依赖锁文件
├── .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. 请求格式：

可用工具:
  - add: 添加两个数字
  - sub: 减去两个数字
  - mul: 乘以两个数字
  - div: 将一个数字除以另一个

请输入您要使用的工具：add

请输入第一个数字：3
请输入第二个数字：4

3. 响应格式：

结果:: 3 + 4 = 7

配置

通过修改compose.yaml中的环境变量来调整以下设置：

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

开发

1. 本地设置：

pip install uv # 推荐安装

uv venv

uv add -r requirements.txt

uv run ./src/server.py

2. 测试：

uv run .\src\client.py

3. 输出示例：

可用工具:
  - add: 添加两个数字
  - sub: 减去两个数字
  - mul: 乘以两个数字
  - div: 将一个数字除以另一个

请输入您要使用的工具：add

请输入第一个数字：3
请输入第二个数字：4

结果:: 3 + 4 = 7

许可证

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