Information
Cal Server
项目简介
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:
npx -y @smithery/cli install @pwh-pwh/cal-mcp --client claude
mcp客户端配置
"cal-mcp": \{
"name": "计算",
"description": "",
"isActive": true,
"command": "bunx",
"args": [
"cal-mcp"
]
\}
手动安装
克隆项目仓库:
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 兼容。