A simple calculator app using Model Context protocol

Model Context Protocol を使用したシンプルな電卓アプリ

このリポジトリの目的

MCP の基本的な構成要素と、MCP 内でのツール呼び出しの仕組みをゼロから探ることを目的としています。多くのエッジケースには対応せず、できるだけシンプルにしています。MCP サーバーとクライアントの両方の構築方法を理解できます。

主な機能

加算、減算、乗算、除算、剰余の計算ができる電卓アプリ

MCP Inspector を使用したサーバーのデバッグ

上記の演算を実行するために、ユーザーからのクエリを受け取る MCP ベースのクライアント

手早くコンセプトを試すための今後の可能性

逐次的なツール呼び出し

シンプルさを保つため、以前のチャット履歴の保存には対応していません

サーバーおよび／またはクライアントによる入力検証

🚨 このリポジトリで使用している FastMCP、Anthropic のツール呼び出し、MCP 自体などの技術は、いずれも非常に新しいものです。そのため、これらの技術には利用できない機能や不具合のある機能が存在します。ただし、主な目的は Cursor や Claude Desktop を使わずに、シンプルに試してみることです 🚨

MCP 準拠の電卓サーバー

シンプルで、自動エラー処理に対応しているため、FastMCP を使用して構築しています。 覚えておく点：

サーバー名は必ず mcp、server、app のいずれかにしてください。それ以外の場合は、明確なエラーが発生します

注釈は今後の参考用に追加できます。現在、uv.lock のバージョンの FastMCP ではサポートされていません

MCP クライアント

MCP サーバーに接続し、LLM にアクセスできる必要があります。 モデルがツールを使用したときに返されるオブジェクトと、一般的な応答を調べて確認することを強くおすすめします。 さまざまな形式の数値を指定して、負荷テストを試してみてください。 例：Add 2 and 3 対 Add two and three。 例：曖昧な数値や大きな数値を使ってみてください：Add seven hundred thousand trillion with three hundred billion

ワークフローの概要

.toml ファイルがある作業環境を再現するには

uv sync

作業環境を有効化するには

source .venv/bin/activate

サーバーを確認するには

fastmcp_calculator_server フォルダーに移動して、以下を実行します
mcp dev server.py

Anthropic API キーを .env ファイルに追加します

MCP アプリ全体を実行するには

mcp_calculator/mcp_compliant_client に移動して、以下を実行します
python client.py <path to server.py>

詳しくは medium. をご覧ください。