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 运行时（推荐最新版本）。
安装
Installing via Smithery
To install cal-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @pwh-pwh/cal-mcp --client claudemcp客户端配置
"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 兼容。
