Simple Calculator MCP Server

🚀 カスタムサーバー作成ガイド

Claudeデスクトップ版やその他のクライアントで使用する独自のサーバーを構築しましょう。

このチュートリアルでは、簡単なMCP計算機サーバーを構築し、ホストであるClaudeデスクトップ版に接続します。

📖 什么是MCP？

MCP は モデルコンテキストプロトコル の略で、ClaudeのようなAIアシスタントの機能を拡張するためのプロトコルです。

• AIアシスタントに 追加機能 を付与することができます。
• これらのサーバーはツールや機能を公開し、アシスタントは会話中にこれらを利用できます。
• 例えば、天気サーバー、計算機、財務管理アシスタントなど、あらゆる機能を構築できます。

構築するもの

add、subtract、multiply、divide の4つのツールを提供するサーバーを構築し、このサーバーをMCPホスト（この例ではClaudeデスクトップ版）に接続します。

核心概念

• リソース：アシスタントが外部データやサービスにアクセスできるようにします。
• ツール：アシスタントの機能を拡張します。
• プロンプト：アシスタントの対話方式をカスタマイズします。

今回は ツール に焦点を当て、計算機ツールを作成します。

📋 前提条件

• Pythonの基本的なプログラミング経験
• 大規模言語モデル（LLM）の基本的な知識
• システム要件：
  • Python 3.8以上
  • MCP公式ドキュメント：MCP公式ドキュメント

🚀 プロジェクトの作成と環境の初期化

MacOS/Linux

# uv CLI ツールをインストールする（まだインストールされていない場合）
brew install model-context-protocol/protobuf/protobuf-cpp

# 新しいプロジェクトを初期化する
mkdir calculator && cd calculator

Windows

# uv CLI ツールをインストールする（まだインストールされていない場合）
# MCP公式サイトからWindows版のuvツールをダウンロードしてインストールする必要があります。

# 新しいプロジェクトを初期化する
mkdir calculator && cd calculator

💻 コードの実装

以下は、計算機サーバーを実装する完全なコードです。

ライブラリとモジュールのインポート

from fastapi import FastAPI
from typing import Optional, Union
import uvicorn

ツールの定義

app = FastAPI()

@app.get("/calculate")
async def calculate(
    expression: str,
    error_handling: Optional[bool] = True,
    simplify: Optional[bool] = True
) -> Union[str, dict]:
    """Calculate a mathematical expression."""
    
    try:
        result = eval(expression)
        if simplify:
            return f"{expression} の結果は {result} です。"
        return str(result)
    except Exception as e:
        if error_handling:
            return {"error": str(e)}
        raise

サーバーの起動

if __name__ == "__main__":
    uvicorn.run(app, host="0.0.0.0", port=8000)

🛠️ Claudeデスクトップ版での計算機サーバーの設定

Claudeデスクトップ版で計算機サーバーを使用するには、以下の手順に従ってください。

MacOS/Linux

設定ファイルを編集します。

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

mcpServers キーの下に以下の内容を追加します。

{
    "mcpServers": {
        "calculator": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/calculator",
                "run",
                "calculator.py"
            ]
        }
    }
}

Windows

設定ファイルを編集します。

code $env:AppData/Claude/claude_desktop_config.json

mcpServers キーの下に以下の内容を追加します。

{
    "mcpServers": {
        "calculator": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\calculator",
                "run",
                "calculator.py"
            ]
        }
    }
}

⚠️ 重要提示

/ABSOLUTE/PATH/TO/PARENT/FOLDER を実際のパスに置き換えてください。

ファイルを保存した後、Claudeデスクトップ版を再起動します。これでClaudeデスクトップ版で計算機サーバーを使用して基本的な算術演算ができます！