SimpleCalculator using Model Context Protocol (MCP) Server & Docker

Model Context Protocol（MCP）サーバーと Docker を使用した SimpleCalculator

算術演算を行うカスタム Model Context Protocol（MCP）の実装例です。シームレスにデプロイできるよう、Docker でコンテナ化されています。

---

特長

• MCP の実装：数学演算を処理するカスタムプロトコル
• 基本演算：加算、減算、乗算、除算
• コンテナ化アーキテクチャ：Docker ベースのデプロイ
• 依存関係の管理：pyproject.toml と uv.lock を使用した最新の Python パッケージ管理
• プロトコルのセキュリティ：コンテナ分離による基本的な通信セキュリティ

---

プロジェクト構成

.
├── src/                # MCP server implementation
├── Dockerfile          # Container build instructions
├── compose.yaml        # Orchestration configuration
├── requirements.txt    # Python dependencies
├── pyproject.toml      # Project metadata
├── uv.lock             # Dependency lock file
├── .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. リクエスト形式：

Available tools:
  - add: Add 2 numbers
  - sub: Subtract 2 numbers
  - mul: Multiply 2 numbers
  - div: Divide 2 numbers

Enter the tool you want to use: add

Enter 1st Number: 3
Enter 2nd Number: 4

3. レスポンス形式：

Result:: 3 + 4 = 7

---

設定

compose.yaml の環境変数を変更して、次の項目を調整します。

• サーバーのポートバインド
• ログの詳細度
• プロトコルのタイムアウト

---

開発

1. ローカル環境のセットアップ：

pip install uv # recommended

uv venv

uv add -r requirements.txt

uv run ./src/server.py

2. テスト：

uv run .\src\client.py

3. 出力：

Available tools:
  - add: Add 2 numbers
  - sub: Subtract 2 numbers
  - mul: Multiply 2 numbers
  - div: Divide 2 numbers

Enter the tool you want to use: add

Enter 1st Number: 3
Enter 2nd Number: 4

Result:: 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. プルリクエストを作成します

---

メンテナー

Dion Ben Fernandes - GitHub プロフィール

---

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