pwh-pwh/cal-mcp

分类General
作者Community
星标688
定价Free

简介

cal-mcp 是一个轻量级的 MCP 服务端，旨在解决 LLM 在处理复杂数学运算时容易出现的“幻觉”或计算错误问题。它通过将计算任务从模型推理交给专业的数学计算引擎，让 AI 能够精准执行数学表达式运算。对于开发者而言，它相当于给 Claude 等支持 MCP 的客户端安装了一个可靠的计算器插件，无需编写复杂的 Prompt 引导，即可在对话中实现高精度的数值计算，非常适合需要处理数据核算、公式解析的工程场景，上手几乎零门槛。

核心亮点

  • 消除 LLM 数学计算幻觉，确保结果绝对精准
  • 即插即用，快速扩展 AI 客户端的计算能力
  • 支持复杂数学表达式，覆盖多种运算场景
  • 轻量化部署，无缝集成至 MCP 生态工作流

完整文档

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 运行时（推荐最新版本）。

安装

通过 Smithery 安装

通过 Smithery 为 Claude Desktop 自动安装 cal-mcp：

bash
npx -y @smithery/cli install @pwh-pwh/cal-mcp --client claude
### MCP Client Configuration
json
"cal-mcp": {
      "name": "计算",
      "description": "",
      "isActive": true,
      "command": "bunx",
      "args": [
        "cal-mcp"
      ]
    }
### Manual Installation
1. Clone the project repository:
bash
git clone <仓库地址>
2. Enter the project directory and install dependencies:
bash
bun install
## Usage

1. Start the service:

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

托管部署可用作 Fronteir AI。

查看官方来源