MCP Calculator Server

MCP Calculator Server

堅牢な数学演算機能を提供する、Model Context Protocol（MCP）サーバーです。公式の go-sdk を使用して構築されています。

機能

ツール

• calculate：適切な演算子の優先順位、括弧への対応、科学表記法による数学演算
• random_number：さまざまな確率分布を使用して、指定された範囲内の乱数を生成します（分布が指定されていない場合は、エリシテーションを使用します）

どちらのツールも、ツールアノテーション（読み取り専用、閉世界のヒント）、タイトル、構造化出力スキーマを宣言します。

リソース

• math://constants：JSON 形式の数学定数（π、e、φ、√2、ln2、ln10）
• math://constants/{name}：リソーステンプレート — 名前で指定する単一の定数。例：math://constants/pi
• server://info：サーバー情報と機能の概要

プロンプト

• math_problem：難易度とトピックを設定できる数学の文章題を生成します
• explain_calculation：数学式を段階的に説明します

プロトコル機能

• 補完：プロンプト引数（difficulty、topic）とリソーステンプレート内の定数名の引数補完
• エリシテーション：random_number は、分布が指定されていない場合に、使用する分布をクライアントに尋ねます
• ログ記録：ツールのアクティビティは、stderr に加えて MCP のログメッセージとしてクライアントに転送されます
• アイコンとメタデータ：サーバーとツールのアイコン、タイトル、ウェブサイト URL、指示

トランスポートモード

• stdio：ローカルクライアント（Cursor、Claude Desktop、MCP Inspector）向けです。特別な理由がなければ、こちらを使用してください。
• streamable-http：信頼できるネットワークでのみ使用してください。すべてのインターフェースにバインドされ、認証も Origin チェックもありません。認証（および Origin）を強制するリバースプロキシの背後に配置するか、外部に公開しないでください。

デフォルト：

• トランスポート：TRANSPORT が未設定の場合は streamable-http（デモに便利ですが、本番環境向けのデフォルトではありません）
• ポート：8080（PORT）

使い捨てのデモ以外で使用する場合は、TRANSPORT=stdio を実行するか、HTTP の前段で TLS と認証を終端してください。

インストール

Linux、macOS、Windows（amd64/arm64）向けのビルド済みバイナリは、各 GitHub リリース に添付されています。

または、Go を使用してインストールします。

go install github.com/yinebebt/mcp-calculator-server@latest

使用方法

# Run with stdio
TRANSPORT=stdio mcp-calculator-server

# Run with HTTP (serves MCP at :8080/mcp, health check at /health)
mcp-calculator-server

# Test
go test ./...

MCP クライアントの設定

MCP Client でテストする場合：

{
  "command": "/path/to/mcp-calculator-server",
  "env": {
    "TRANSPORT": "stdio"
  }
}

数学機能

• 演算子の優先順位：2+3*4 = 14
• 括弧：(2+3)*4 = 20
• 科学表記法：1e2 = 100
• エラー検出：ゼロ除算、無効な構文、対応しない括弧、有限でない結果（NaN/Inf）

リリース

リリースは、GitHub Actions を介して GoReleaser でビルドされます。vX.Y.Z タグをプッシュすると、linux/darwin/windows × amd64/arm64 向けにクロスコンパイルされ、アーカイブとチェックサムが GitHub リリースに添付されます。