mcpField
C
Cal Server

Cal Server

Local
smithery.aiScience & Education13Updated 3d ago
RepositoryVisit website

About Cal Server

Cal Server is a FastMCP-based math expression service running on Bun, for clients that need calculations through MCP. It parses expressions with expr-eval and includes E, PI, and boolean constants.

Key features

  1. 01Evaluate math expressions
  2. 02Support E and PI constants
  3. 03Support true and false

Use cases

  1. 01Calculate basic arithmetic expressions
  2. 02Use E or PI in an expression
  3. 03Get expression results through MCP

MCP support

It exposes a `cal` tool over stdio, accepting the string parameter `exp` and returning the calculation result.

#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "cal": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Cal Server

Trust Score LightNow capabilities

Cal Server MCP 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 + 2 → 4
    • 使用常量：PI * 2 → 6.283185307179586
    • 复杂表达式：E ^ 2 + 1 → 8.38905609893065

注意事项

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

Hosted deployment

A hosted deployment is available on Fronteir AI.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.