项目介绍
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 自动安装 cal-mcp 到 Claude Desktop：
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 兼容。