Mathematical Calculator MCP Server

数学計算 MCP サーバー

これは、記号数学、統計分析、行列演算などの高度な数学計算機能を Claude に提供する Model Context Protocol（MCP）サーバーです。

機能

数学計算 MCP サーバーでは、次のツールを利用できます。

• 基本計算：数式を安全に評価します
• 記号数学：
  • 方程式を解きます（一次方程式、二次方程式、多項式など）
  • 数式の導関数を計算します
  • 数式の積分を計算します
• 統計分析：
  • 平均値、中央値、最頻値
  • 分散、標準偏差
  • 相関係数
  • 線形回帰
  • 信頼区間
• 行列演算：
  • 行列の加算
  • 行列の乗算
  • 行列の転置

インストール

前提条件

• Python 3.10+（推奨：Python 3.11+）
• uv（推奨）または pip
• Claude デスクトップアプリ（MCP サーバーを Claude と一緒に使用する場合）

インストール手順

1. リポジトリをクローンします：

   git clone https://github.com/huhabla/calculator-mcp-server.git
   cd calculator-mcp-server
   

2. （オプション 1）付属のスクリプトを使ってセットアップします：

   chmod +x setup_venv.sh
   ./setup_venv.sh
   

   （オプション 2）または、仮想環境を手動でセットアップします：

   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   

3. ドキュメントテストを実行して、すべてが正しく動作することを確認します：

   bash run_doctests.sh
   

Claude デスクトップアプリとの連携

方法 1：Claude デスクトップアプリで設定する

サーバーを Claude デスクトップアプリの設定ファイルに追加します。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

mcpServers セクションに次の内容を追加します：

{
  "mcpServers": {
    "calculator": {
      "command": "uvx",
      "args": [
        "--from",
        "calculator-mcp-server@git+https://github.com/huhabla/calculator-mcp-server.git",
        "--",
        "calculator-mcp-server",
        "--stdio"
      ]
    }
  }
}

注：Claude デスクトップアプリと正しく連携するには、--stdio フラグが必要です。-- は uvx の引数と計算サーバーの引数を区切ります。

方法 2：FastMCP でインストールする

1. uv がインストールされていることを確認します（インストールガイド）

2. Claude デスクトップアプリに MCP サーバーをインストールします：

   fastmcp install calculator_server.py
   

   または、カスタム名を指定してインストールします：

   fastmcp install calculator_server.py --name "Math Calculator"
   

3. インストールすると、Claude はすべての数学ツールと関数を自動的に利用できるようになります。

使用例

Claude デスクトップアプリとの連携後、Claude にさまざまな数学演算を依頼できます。以下に例を示します。

基本計算

Can you calculate 3.5^2 * sin(pi/4)?

方程式を解く

Solve the following equation: x^2 - 5x + 6 = 0

導関数の計算

What's the derivative of sin(x^2) with respect to x?

積分の計算

Calculate the integral of x^2 * e^x

統計分析

Find the mean, median, mode, and standard deviation of this dataset: [23, 45, 12, 67, 34, 23, 18, 95, 41, 23]

線形回帰

Perform a linear regression on these points: (1,2), (2,3.5), (3,5.1), (4,6.5), (5,8.2)

行列演算

Multiply these two matrices:
[1, 2, 3]
[4, 5, 6]

and

[7, 8]
[9, 10]
[11, 12]

開発

テスト

包括的な doctest スイートを実行します：

bash run_doctests.sh

対話型開発モード

開発やデバッグには、FastMCP の開発モードを使用できます：

fastmcp dev calculator_server.py

これにより、すべてのツールを対話形式でテストできるローカルのウェブインターフェースが起動します。

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルをご覧ください。

謝辞

• Python らしい MCP サーバーフレームワークを提供する FastMCP
• 記号数学を提供する SymPy
• 数値計算と統計計算を提供する NumPy および SciPy