Calcport

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Oct 29, 2026

Safe arithmetic: evaluate expressions and add, subtract, multiply, divide.

已驗證STDIO僅桌面開發者工具

概覽

AI 產生的概覽

Calcport 是本地 MCP 伺服器，為助理提供安全的算術能力：一個運算式求值器，以及加、減、乘、除四個工具。

可以做什麼
  • 求值運算式，支援運算子、括號、sqrt、abs、floor、ceil、round 以及常數 pi 和 e
  • 將兩個數字相加
  • 用一個數字減去另一個數字
  • 將兩個數字相乘
  • 用一個數字除以另一個數字，除以零時回報錯誤
適用情境
適合需要助理進行精確算術或核對計算結果的情境，尤其是希望使用極小、受限的求值器，而非通用程式碼執行工具時。
執行需求
以本機程序透過 stdio 執行，可用 npx 從 npm 套件啟動，或用 docker 從容器映像啟動。未宣告帳號、API 金鑰、環境變數或請求標頭，執行時不需要網路存取。
安裝前請注意
這些工具只做數值計算並回傳結果，不會寫入、傳送或刪除任何資料。求值器是手寫解析器，僅限算術，無法執行程式碼、shell 指令或屬性查找。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Calcport，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

calcport

calcport does arithmetic safely. Its centrepiece is an expression evaluator that understands the usual operators, parentheses, a handful of functions, and the constants pi and e — and nothing else. The evaluator is a hand-written parser, so an expression can never turn into code execution, a shell call, or a property lookup. Around it sit four single-purpose operations for callers that just need one sum, difference, product, or quotient.

Install

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

Or run the container image:

bash
docker run -i ghcr.io/cloudcorprecords/calcport

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash
# Evaluate an expressioncalcport calculate "sqrt(3^2 + 4^2) + pi"# 8.141592653589793
# Single operationscalcport add 2 3          # 5calcport subtract 10 4    # 6calcport multiply 2.5 4   # 10calcport divide 7 2       # 3.5
# Machine-readable outputcalcport calculate "2^10" --jsoncalcport add 2 3 --json
calcport --version

Expressions may use + - * / % ^, parentheses, unary minus, the functions sqrt, abs, floor, ceil, and round, and the constants pi and e. ^ is right-associative, so 2^3^2 is 512.

Exit codes: 0 on success, 1 when a calculation cannot be done (division by zero, a malformed expression — the error says why), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

bash
npx -y @reneturcios/calcport mcp

MCP client configuration:

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

Tools

ToolInputWhat it returns
calculateexpression (string, required)The numeric result of the expression, with the expression echoed back.
adda, b (numbers, required)a + b, with both operands.
subtracta, b (numbers, required)a - b, with both operands.
multiplya, b (numbers, required)a * b, with both operands.
dividea, b (numbers, required)a / b, with both operands. Dividing by zero is an error.

Development

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

License

MIT — see LICENSE.

來源：README.md，提交 b3087c2

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Oct 29, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分