Cal Server

by pwh-pwh

Utilities math expression calculator bun fastmcp

Cal Server is a simple math expression calculation service built on the FastMCP framework, using the Bun runtime environment. It leverages the expr-eval library to parse and calculate user-inputted math expressions via stdio.

Last updated: N/A

Cal Server

smithery badge

项目简介

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:

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

mcp客户端配置

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

Manual Installation

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

使用方法

启动服务：
```
bun run index.ts
```
服务将通过标准输入输出（stdio）运行。
输入数学表达式：
- 示例输入：2 + 3 * PI
- 输出：计算结果（字符串形式）。
支持的表达式示例：
- 基本运算：2 + 2 → 4
- 使用常量：PI * 2 → 6.283185307179586
- 复杂表达式：E ^ 2 + 1 → 8.38905609893065

注意事项

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