Calculator MCP Server

Calculator MCP サーバー

TypeScript を使用して Model Context Protocol（MCP）サーバーとして実装された、包括的な電卓です。

このサーバーは、幅広い数学関数を MCP ツールとして提供し、MCP クライアント（Claude for Desktop、Cursor など）を介して接続された言語モデルが計算を行えるようにします。

機能

次の MCP ツールを提供します。

• 基本的な算術演算： 加算、減算、乗算、除算
• 累乗と平方根： 累乗（^）、平方根
• 三角関数： サイン、コサイン、タンジェント（入力はラジアン）
• 逆三角関数： アークサイン、アークコサイン、アークタンジェント、Arctan2（出力はラジアン）
• 度とラジアンの変換： 度とラジアンを相互に変換
• 対数： 自然対数（ln）、常用対数（log10）、任意の底の対数
• 定数： 円周率（π）、ネイピア数（e）
• 階乗： n!
• パーセンテージ： 数値のパーセンテージを計算
• 剰余： 余りの演算
• 絶対値： abs()
• 丸め： 切り捨て、切り上げ、最も近い整数への丸め

前提条件

• Node.js（v16 以上を推奨）
• npm（通常は Node.js に同梱されています）

インストール

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

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

2. プロジェクトディレクトリに移動します。

   cd calculator-mcp-server
   

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

   npm install
   

サーバーのビルド

• TypeScript コードをビルドします。

  npm run build
  

  これにより、コードが build ディレクトリにコンパイルされます。

クライアントへの接続（Claude Desktop の例）

このサーバーは MCP stdio トランスポートを使用して通信します。Claude for Desktop に接続するには、次の手順に従います。

1. Claude Desktop の MCP 設定ファイルを見つける：

   • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows： %APPDATA%\Claude\claude_desktop_config.json（このパスをエクスプローラーのアドレスバーに貼り付けられます）。
   • Linux： ~/.config/Claude/claude_desktop_config.json
   • ファイルまたは Claude ディレクトリが存在しない場合は、作成する必要があります。または、Claude Desktop の設定（Claude Menu > Settings... > Developer > Edit Config）を開くと、ファイルが作成されるはずです。

2. 設定ファイルを編集する： テキストエディターで claude_desktop_config.json ファイルを開きます。

3. サーバー設定を追加する： ファイルを変更し、計算機サーバーのエントリーを含む mcpServers オブジェクトを追加します。ファイルが空、または存在しない場合は、内容全体を次のようにします。

   {
     "mcpServers": {
       "calculator": {
         "command": "node",
         "args": [
           "/home/marco/code/calculator-mcp-server/build/index.js"
           // IMPORTANT: Replace this path with the ACTUAL ABSOLUTE PATH
           // to the 'build/index.js' file on YOUR system.
         ]
       }
       // You can add other servers here under different keys, like:
       // "another_server": { ... }
     }
   }
   

   注意：

   • 重要： /home/marco/code/calculator-mcp-server/build/index.js を、お使いのコンピューター上にあるクローン済みプロジェクトディレクトリ内の build/index.js ファイルへの正しい絶対パスに置き換えてください。
   • Windows では、パス区切り文字に二重のバックスラッシュ（\\）を使用します。例："C:\\Users\\YourUser\\path\\to\\calculator-mcp-server\\build\\index.js"。
   • キー "calculator" は、Claude の設定でこのサーバー接続に付ける名前にすぎません。内容が分かりやすければ、どのような名前でもかまいません。
   • mcpServers オブジェクトがすでに存在する場合は、その中に "calculator": { ... } エントリーを追加します。他のサーバーがある場合は、カンマで区切ってください。

4. Claude for Desktop を再起動する： 新しい設定を反映するため、Claude for Desktop を完全に終了してから、再度開いてください。

これで Claude for Desktop に MCP ツールのアイコン（ハンマー ）が表示され、計算を依頼すると計算機ツールを使用できるようになります。

ライセンス

MIT ライセンス