pwh-pwh/cal-mcp

CategoryGeneral
AuthorCommunity
Stars688
PricingFree

Overview

The cal-mcp server extends LLM capabilities by offloading mathematical computations to a dedicated execution environment, eliminating the common 'hallucination' issues associated with complex arithmetic in large language models. Instead of relying on probabilistic token prediction for math, this tool allows the model to perform precise calculations via a standardized interface. It is particularly useful for developers building agents that require high numerical accuracy for financial data, scientific formulas, or dynamic coordinate calculations. Integration is straightforward via the Model Context Protocol, allowing any MCP-compatible client to treat the calculator as a native tool without requiring custom wrapper code for every new mathematical operation.

Highlights

  • Eliminates LLM arithmetic hallucinations with precise execution
  • Standardized MCP integration for seamless tool discovery
  • Ideal for financial and scientific agent workflows
  • Lightweight implementation with minimal configuration overhead

Full Documentation

Cal Server

![Trust Score](https://archestra.ai/mcp-catalog/pwh-pwh__cal-mcp) ![smithery badge](https://smithery.ai/server/@pwh-pwh/cal-mcp)

<a href="https://glama.ai/mcp/servers/@pwh-pwh/cal-mcp">
<img width="380" height="200" src="https://glama.ai/mcp/servers/@pwh-pwh/cal-mcp/badge" alt="Cal Server MCP server" />
</a>

项目简介

Cal Server 是一个基于 FastMCP 框架构建的简单数学表达式计算服务，使用 Bun 运行时环境。它利用 expr-eval 库解析和计算用户输入的数学表达式，并通过标准输入输出（stdio）与外界交互。该项目旨在提供一个轻量、高效的计算工具，支持基本数学运算和内置常量。

功能

  • 表达式计算：支持用户输入数学表达式并返回计算结果。
  • 内置常量：
- E：Bun 环境中的 Math.E。 - PI：Bun 环境中的 Math.PI。 - true：逻辑真值。 - false：逻辑假值。
  • 工具名称：cal。
  • 参数：接受一个字符串类型的数学表达式（exp）。

依赖

  • fastmcp：用于构建 MCP 服务。
  • expr-eval：用于解析和计算数学表达式。
  • zod：用于参数验证。

前置条件

  • 确保已安装 Bun 运行时（推荐最新版本）。

安装

Installing via Smithery

To install cal-mcp for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @pwh-pwh/cal-mcp --client claude

mcp客户端配置

json
"cal-mcp": {
      "name": "计算",
      "description": "",
      "isActive": true,
      "command": "bunx",
      "args": [
        "cal-mcp"
      ]
    }

Manual Installation

1. 克隆项目仓库：
bash
git clone <仓库地址>
2. 进入项目目录并安装依赖：
bash
bun install

使用方法

1. 启动服务：

bash
bun run index.ts

服务将通过标准输入输出（stdio）运行。

2. 输入数学表达式：
- 示例输入：2 + 3 * PI
- 输出：计算结果（字符串形式）。

3. 支持的表达式示例：
- 基本运算：2 + 2 → 4
- 使用常量：PI * 2 → 6.283185307179586
- 复杂表达式：E ^ 2 + 1 → 8.38905609893065

注意事项

  • 输入的表达式必须是有效的数学表达式，否则可能抛出错误。
  • 服务当前仅支持通过 stdio 交互。
  • 项目使用 Bun 运行时，确保命令与 Bun 兼容。

Hosted deployment

A hosted deployment is available on Fronteir AI.

View official source
Join our Telegram