Cal Server

by pwh-pwh
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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 claude

mcp客户端配置

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

Manual Installation

  1. 克隆项目仓库:
    git clone <仓库地址>
  2. 进入项目目录并安装依赖:
    bun install

使用方法

  1. 启动服务:
    bun run index.ts
    服务将通过标准输入输出(stdio)运行。
  2. 输入数学表达式:
    • 示例输入:2 + 3 * PI
    • 输出:计算结果(字符串形式)。
  3. 支持的表达式示例:
    • 基本运算:2 + 24
    • 使用常量:PI * 26.283185307179586
    • 复杂表达式:E ^ 2 + 18.38905609893065

注意事项

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

A mathematical expression calculator that processes user-input expressions and returns computed results, supporting basic operations and built-in constants like PI and E.

  1. 项目简介
    1. 功能
      1. 依赖
        1. 前置条件
          1. 安装
            1. Installing via Smithery
            2. mcp客户端配置
            3. Manual Installation
          2. 使用方法
            1. 注意事项
              ID: nspz0vl14d