Cal Server

Cal Server

プロジェクトの概要

Cal Server は、Bun ランタイム環境で動作する、FastMCP フレームワークを基盤としたシンプルな数式計算サービスです。expr-eval ライブラリを使って、ユーザーが入力した数式を解析して計算し、標準入力と標準出力（stdio）を介して外部と通信します。このプロジェクトは、基本的な数学演算と組み込み定数に対応した、軽量で効率的な計算ツールを提供することを目的としています。

機能

• 式の計算：ユーザーが入力した数式を計算し、結果を返します。
• 組み込み定数：
  • E：Bun 環境の Math.E。
  • PI：Bun 環境の Math.PI。
  • true：論理値の真。
  • false：論理値の偽。
• ツール名：cal。
• パラメーター：文字列型の数式（exp）を受け取ります。

依存関係

• fastmcp：MCP サービスの構築に使用します。
• expr-eval：数式の解析と計算に使用します。
• zod：パラメーターの検証に使用します。

前提条件

• Bun ランタイムがインストールされていることを確認してください（最新バージョンを推奨）。

インストール

Smithery 経由でのインストール

Smithery 経由で、Claude Desktop に 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
   

使用方法

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 と互換性を持つことを確認してください。

ホステッドデプロイ

Fronteir AI でホステッドデプロイを利用できます。