Skip to main content
Glama
calc_mcp

calc_mcp

by nocodig

calc_mcp

Ein Taschenrechner-MCP-Dienst, der über stdio die vier Grundrechenarten Addition, Subtraktion, Multiplikation und Division bereitstellt.

Es nutzt die FastMCP-API des offiziellen MCP Python SDK; die Abhängigkeit ist auf 1.x beschränkt, um Schnittstellenänderungen durch Hauptversions-Upgrades zu vermeiden.

Verfügbare Tools

Alle Tools akzeptieren zwei erforderliche numerische Parameter a, b und unterstützen ganze Zahlen, Dezimalzahlen und negative Zahlen.

Tool

Operation

Beispiel für Aufrufparameter

Ergebnis

add

a + b

{"a": 2, "b": 3}

5.0

subtract

a - b

{"a": 2, "b": 5}

-3.0

multiply

a * b

{"a": -3, "b": 4}

-12.0

divide

a / b

{"a": 7, "b": 2}

3.5

Bei erfolgreichen Aufrufen ist structuredContent {"result": 数值}; zusätzlich wird kompatibler Textinhalt bereitgestellt. Die Tools lesen und schreiben keine Dateien und greifen nicht auf das Netzwerk zu.

Fehler werden über isError: true im MCP-Toolergebnis zurückgegeben und unterbrechen den Dienst nicht:

  • Divisor ist 0 oder -0.0: Cannot divide by zero.

  • Bei NaN- oder unendlichen Operanden: Operands must be finite numbers.

  • Wenn das Ergebnis in unendlich überläuft: Result exceeds the supported finite number range.

  • Fehlende Parameter oder nicht parsebare Zahlenwerte werden vom SDK als Parametervalidierungsfehler zurückgegeben.

Die Berechnungen verwenden Pythons Doppelpräzisions-Gleitkommazahlen; es gelten die üblichen Gleitkomma-Rundungsfehler, z. B. kann 0.1 + 0.2 den Wert 0.30000000000000004 liefern. Das Tool ist nicht für Szenarien gedacht, die dezimal exakte Berechnung erfordern; diese Version unterstützt keine Ausdrucksauswertung.

Related MCP server: My Calculator MCP Server

Verzeichnisstruktur

calc_mcp/
├── pyproject.toml          # 项目、依赖和命令行入口
├── uv.lock                 # 依赖版本锁定
├── README.md
├── .gitignore
├── src/calc_mcp/
│   ├── __init__.py
│   ├── __main__.py         # python -m calc_mcp 入口
│   ├── server.py           # MCP 实例和 stdio 启动
│   └── tools.py            # 四则运算、边界检查和工具注册
└── tests/
    └── test_server.py      # 算术单元测试和 stdio 集成测试

Installation und Start

Erforderlich sind Python 3.10+ und uv. Führen Sie in diesem Projektverzeichnis Folgendes aus:

uv sync
uv run calc-mcp

Alternativ kann der Dienst über den Modul-Einstiegspunkt gestartet werden:

uv run python -m calc_mcp

Der Dienst kommuniziert über Standardeingabe/-ausgabe mit MCP-Clients und bietet keine Weboberfläche. Es ist normal, dass er nach dem direkten Start auf Client-Nachrichten wartet. Geben Sie keine Debug-Informationen auf stdout aus; Logs sollten auf stderr geschrieben werden.

Beispielkonfiguration für MCP-Clients

Das Folgende gilt für Clients, die das JSON-Konfigurationsformat mcpServers verwenden; passen Sie es an Ihren tatsächlichen Client an:

{
  "mcpServers": {
    "calc-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/lifang/product/0826/calc_mcp",
        "run",
        "calc-mcp"
      ]
    }
  }
}

Wenn der Client uv nicht findet, ändern Sie command auf den absoluten Pfad der ausführbaren Datei uv. Nach dem Verschieben des Projekts muss der Verzeichnispfad aktualisiert werden.

Verifizierung

uv run python -m unittest discover -s tests -v

Die Tests decken die vier Grundrechenarten, negative Zahlen, Dezimalzahlen, Null, ungültige Parameter, nicht endliche Zahlen und Überlauf ab. Sie starten einen echten stdio-Unterprozess und prüfen die MCP-Initialisierung, Tool-Erkennung, Tool-Aufrufe sowie normale Aufrufe nach Fehlern.

Zukünftige Erweiterungspunkte

Fügen Sie Tool-Definitionen in src/calc_mcp/tools.py hinzu und nehmen Sie die Funktionen in die Registrierungsliste von register_tools() auf. create_server() in server.py registriert die Tools einheitlich.

Available Tools

4 tools
addA
Read-onlyIdempotent

Add two finite numbers: a + b.

Inputs: a (required), b (required). Returns: result

divideA
Read-onlyIdempotent

Divide a by b: a / b. Operands must be finite and b must not be zero.

Inputs: a (required), b (required). Returns: result

multiplyA
Read-onlyIdempotent

Multiply two finite numbers: a * b.

Inputs: a (required), b (required). Returns: result

subtractA
Read-onlyIdempotent

Subtract b from a: a - b. Both operands must be finite numbers.

Inputs: a (required), b (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool maps to a single, distinct arithmetic operation: addition, subtraction, multiplication, or division. There is no overlap or ambiguity between tool purposes.

    Naming Consistency5/5

    All tool names follow the same simple verb-only pattern: add, subtract, multiply, divide. The naming is perfectly consistent and instantly predictable.

    Tool Count5/5

    Four tools is the ideal size for a basic arithmetic calculator server. Each tool covers a fundamental operation without unnecessary bloat.

    Completeness5/5

    The tool set fully covers the core arithmetic operations needed for a calculator: addition, subtraction, multiplication, and division, with appropriate edge-case handling for division by zero. It is a complete minimal surface for its stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      D
      quality
      D
      maintenance
      Provides basic mathematical operations (addition, subtraction, multiplication, division) through a calculate tool. Supports both stdio and HTTP/SSE transport modes.
      1
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes add, subtract, multiply, and divide tools for performing arithmetic operations over stdio via the Model Context Protocol.
      ISC
    • F
      license
      A
      quality
      C
      maintenance
      Enables an LLM client to perform basic arithmetic on two numbers — addition, subtraction, multiplication, and division — plus reverse a supplied text string, through five simple tools exposed over stdio. Inputs and structured text results follow JSON schemas, with invalid operations such as division by zero surfaced as tool errors.
      5
      -