Cal MCP

🚀 Cal 服務

Cal Server 是一個基於 FastMCP 框架構建的簡單數學表達式計算服務，藉助 Bun 運行時環境，利用 expr-eval 庫解析和計算用戶輸入的數學表達式，通過標準輸入輸出（stdio）與外界交互，為用戶提供輕量、高效的計算工具，支持基本數學運算和內置常量。

🚀 快速開始

前置條件

確保已安裝 Bun 運行時（推薦最新版本）。

啟動服務

1. 啟動服務：

   bun run index.ts
   

   服務將通過標準輸入輸出（stdio）運行。
2. 輸入數學表達式：
   • 示例輸入：2 + 3 * PI
   • 輸出：計算結果（字符串形式）。
3. 支持的表達式示例：
   • 基本運算：2 + 2 → 4
   • 使用常量：PI * 2 → 6.283185307179586
   • 複雜表達式：E ^ 2 + 1 → 8.38905609893065

✨ 主要特性

• 表達式計算：支持用戶輸入數學表達式並返回計算結果。
• 內置常量：
  • E：Bun 環境中的 Math.E。
  • PI：Bun 環境中的 Math.PI。
  • true：邏輯真值。
  • false：邏輯假值。
• 工具名稱：cal。
• 參數：接受一個字符串類型的數學表達式（exp）。

📦 安裝指南

通過 Smithery 安裝

要通過 Smithery 自動安裝 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"
      ]
    }

手動安裝

1. 克隆項目倉庫：

   git clone <倉庫地址>
   

2. 進入項目目錄並安裝依賴：

   bun install
   

📚 詳細文檔

依賴

• fastmcp：用於構建 MCP 服務。
• expr-eval：用於解析和計算數學表達式。
• zod：用於參數驗證。

⚠️ 注意事項

⚠️ 重要提示

• 輸入的表達式必須是有效的數學表達式，否則可能拋出錯誤。
• 服務當前僅支持通過 stdio 交互。
• 項目使用 Bun 運行時，確保命令與 Bun 兼容。