calcport

calcport

calcport は安全に算術計算を行います。中心となるのは、一般的な演算子、括弧、いくつかの関数、定数 pi と e を理解する式評価器です。それ以外は何も扱いません。この評価器は手書きのパーサーなので、式がコード実行、シェル呼び出し、プロパティ参照に変わることはありません。その周囲には、単一の加算、減算、乗算、除算だけが必要な呼び出し側向けに、用途を絞った4つの操作を用意しています。

インストール

npx @reneturcios/calcport calculate "2+3*4"

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/calcport

コンテナーはデフォルトで MCP サーバーを起動します（下記参照）。CLI として使うには、CLI 引数を渡します。

CLI

# Evaluate an expression
calcport calculate "sqrt(3^2 + 4^2) + pi"
# 8.141592653589793

# Single operations
calcport add 2 3          # 5
calcport subtract 10 4    # 6
calcport multiply 2.5 4   # 10
calcport divide 7 2       # 3.5

# Machine-readable output
calcport calculate "2^10" --json
calcport add 2 3 --json

calcport --version

式では + - * / % ^、括弧、単項マイナス、関数 sqrt、abs、floor、ceil、round、定数 pi と e を使用できます。^ は右結合なので、2^3^2 は 512 になります。

終了コード：成功時は 0、計算を実行できない場合（ゼロ除算、不正な式など。理由はエラーに表示されます）は 1、使用方法に関するエラーの場合は 2 です。

MCP サーバー

1つのバイナリで、どちらの用途にも対応します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/calcport mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "calcport": {
      "command": "npx",
      "args": ["-y", "@reneturcios/calcport", "mcp"]
    }
  }
}

ツール

ツール	入力	戻り値
calculate	expression（文字列、必須）	式を併記した、式の数値結果。
add	a、b（数値、必須）	両方のオペランドを併記した a + b。
subtract	a、b（数値、必須）	両方のオペランドを併記した a - b。
multiply	a、b（数値、必須）	両方のオペランドを併記した a * b。
divide	a、b（数値、必須）	両方のオペランドを併記した a / b。ゼロ除算はエラーになります。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。