金大哥 - SimpleCalculator-using-MCP-Server---Docker MCP 详情

article

README

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

SimpleCalculator-using-MCP-Server---Docker