Simplecalculator Using MCP Server Docker

🚀 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

💻 使用例

基本的な使用法

可用工具:
  - 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サーバーは、カスタムプロトコルを通じて計算タスクを処理します。演算の流れは以下の通りです。

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

🔧 技術詳細

MCPサーバーは、カスタムプロトコルを使用して算術演算を処理します。Dockerを使用してコンテナ化されており、依存関係管理にはpyproject.tomlとuv.lockが使用されています。コンテナ隔離により、基本的な通信セキュリティが確保されています。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE.md を参照してください。

🤝 貢献ガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/NewOperation）。
3. 変更をコミットします（git commit -m 'Add modulo operation'）。
4. ブランチにプッシュします（git push origin feature/NewOperation）。
5. プルリクエストを開きます。

👨‍💻 メンテナ

Dion Ben Fernandes - GitHub個人プロフィール

⚠️ 重要提示

この実装は、カスタムのMCPアーキテクチャパターンをデモンストレートしています。本番環境で使用する場合は、適切なプロトコルセキュリティ対策と検証レイヤーの実装を検討してください。