MCP Calculator Demo

MCP 計算機デモ

MCP（Model Control Protocol）フレームワークを使用した計算サービスを紹介するデモプロジェクトです。このプロジェクトは、基本的な算術演算を提供するサーバーと、簡単な数式と複雑な数式の両方を評価できるクライアントで構成されています。

プロジェクト構成

• calculator_server.py：算術演算を提供する MCP サーバー
• client.py：サーバーに接続してユーザー入力を処理するクライアントアプリケーション
• requirements.txt：プロジェクトの依存関係

機能

• 基本的な算術演算（加算、減算、乗算、除算）
• 簡単な演算（例：「add 2 3」）と複雑な数式の両方に対応
• ゼロ除算のエラー処理
• クライアントとサーバー間の Server-Sent Events（SSE）通信
• 数式内の括弧に対応
• 複雑な数式を評価する RPN（逆ポーランド記法）

前提条件

• Python 3.7+
• pip（Python パッケージマネージャー）

インストール

1. リポジトリをクローンします
2. 仮想環境を作成して有効化します：

   python -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

使用方法

サーバーの起動

計算機サーバーを実行します：

python calculator_server.py

サーバーはデフォルトで http://127.0.0.1:5005 で起動します。

クライアントの実行

別のターミナルでクライアントを実行します：

python client.py

利用可能な演算

計算機は次の演算に対応しています：

1. 直接ツール構文：

   • add 2 3
   • subtract 5 2
   • multiply 4 3
   • divide 10 2

2. 複雑な数式：

   • 5+7-2
   • 5+7-2*3
   • (5+7)*2
   • 10/2+3*4

使用例

» add 2 3
Result: 5

» 5+7-2*3
Result: 6

» (5+7)*2
Result: 24

» divide 10 0
Error: Division by zero.

技術的な詳細

• サーバーは MCP 操作の処理に FastMCP を使用します
• クライアントとサーバー間の通信には Server-Sent Events（SSE）を使用します
• クライアントは複雑な数式を解析するために Shunting-Yard アルゴリズムを実装しています
• 無効な数式とゼロ除算のエラー処理を実装しています

依存関係

• fastapi
• uvicorn
• sse-starlette
• fastmcp>=0.1.0
• llama-index
• llama-index-llms-anthropic
• anthropic
• python-dotenv
• requests
• sseclient-py
• uv

ライセンス

このプロジェクトはオープンソースであり、MIT ライセンスの下で利用できます。