calculator-mcp-server

公開ホスト型サーバー: https://calculator.caseyjhand.com/mcp

ツール

すべての数学演算をカバーする 1 つのツール:

calculate

サーバーの目的の 100% をカバーする単一のツールです。operation パラメータはデフォルトで evaluate になるため、一般的なケースでは { expression: "..." } だけで済みます。

• Evaluate（評価） — 算術、三角関数、対数、統計、行列、複素数、単位変換、組合せ論

• Simplify（簡約） — 代数式を記号的（シンボリック）に簡約します（例: 2x + 3x -> 5 * x）。代数恒等式と三角関数の恒等式に対応

• Derivative（微分） — 記号的微分を計算します（例: 3x^2 + 2x + 1 -> 6 * x + 2）

• scope パラメータによる変数スコープ: { "x": 5, "y": 3 }

• 数値結果の精度を設定可能

• フォームベースの MCP クライアントからの空のオプション variable および precision 値は、省略されたものとして扱われます

Related MCP server: pycodemath

リソース

機能

@cyanheads/mcp-ts-core をベースに構築:

• 宣言型ツール定義 — ツールごとに 1 ファイル、フレームワークが登録と検証を処理

• 全ツールにわたる統一エラー処理

• オプションの OpenTelemetry トレーシングを備えた構造化ロギング

• ローカル（stdio/HTTP）または Docker で実行

電卓固有の機能:

• 強化された math.js v15 インスタンス — 危険な関数は無効化、評価は vm.runInNewContext() によるタイムアウト付きサンドボックスで実行

• 認証不要 — すべての操作は読み取り専用かつステートレス

• 入力検証: 式の長さ制限、式セパレータの拒否（セミコロンと改行）、数値のみのスコープ値

• 結果検証: ブロックされた結果タイプ（関数、パーサー、結果セット）、設定可能な最大結果サイズ

• スコープのサニタイズ: 数値のみの値、プロトタイプ汚染の防止（__proto__、constructor などをブロック）

はじめに

公開ホスト型インスタンス

公開インスタンスは https://calculator.caseyjhand.com/mcp で利用可能です — インストールは不要です。Streamable HTTP 経由で任意の MCP クライアントから接続できます:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "streamable-http",
      "url": "https://calculator.caseyjhand.com/mcp"
    }
  }
}

セルフホスト / ローカル

以下のいずれかを MCP クライアントの設定ファイルに追加してください:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/calculator-mcp-server@latest"]
    }
  }
}

または npx を使用（Bun 不要）:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/calculator-mcp-server@latest"]
    }
  }
}

または Docker を使用:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_TRANSPORT_TYPE=stdio",
        "ghcr.io/cyanheads/calculator-mcp-server:latest"
      ]
    }
  }
}

前提条件

• Bun v1.3.0 以上

インストール

1. リポジトリをクローン:

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

2. ディレクトリに移動:

cd calculator-mcp-server

3. 依存関係をインストール:

bun install

設定

オプションのセッション、再開可能性、ロギング、およびテレメトリ設定については .env.example を参照してください。

サーバーの実行

ローカル開発

• 本番バージョンのビルドと実行:

  bun run build
  bun run start:http   # or start:stdio

• チェックとテストの実行:

  bun run devcheck     # Lints, formats, type-checks
  bun run test         # Runs test suite

Docker

docker build -t calculator-mcp-server .
docker run -p 3010:3010 calculator-mcp-server

このイメージはデフォルトでポート 3010 の Streamable HTTP、ステートレスセッション、および /var/log/calculator-mcp-server へのログ出力を使用します。

プロジェクト構造

開発ガイド

開発ガイドラインとアーキテクチャルールについては AGENTS.md または CLAUDE.md を参照してください。要点:

• ハンドラーは例外をスローし、フレームワークがキャッチ — ツールロジックに try/catch は不要

• ロギングには ctx.log を使用

• 新しいツールとリソースは src/index.ts に登録

コントリビューション

Issue とプルリクエストを歓迎します。提出前にチェックを実行してください:

bun run devcheck
bun run test

ライセンス

Apache-2.0 — 詳細は LICENSE を参照してください。