calc_mcp
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 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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
0oder-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-mcpAlternativ kann der Dienst über den Modul-Einstiegspunkt gestartet werden:
uv run python -m calc_mcpDer 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 -vDie 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 toolsaddARead-onlyIdempotent
Add two finite numbers: a + b.
Inputs: a (required), b (required). Returns: result
divideARead-onlyIdempotent
Divide a by b: a / b. Operands must be finite and b must not be zero.
Inputs: a (required), b (required). Returns: result
multiplyARead-onlyIdempotent
Multiply two finite numbers: a * b.
Inputs: a (required), b (required). Returns: result
subtractARead-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
Scored across 4 tools
Each tool maps to a single, distinct arithmetic operation: addition, subtraction, multiplication, or division. There is no overlap or ambiguity between tool purposes.
All tool names follow the same simple verb-only pattern: add, subtract, multiply, divide. The naming is perfectly consistent and instantly predictable.
Four tools is the ideal size for a basic arithmetic calculator server. Each tool covers a fundamental operation without unnecessary bloat.
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
Related MCP Connectors
Evaluates Reverse Polish Notation (postfix) expressions: arithmetic, trig, logs, bitwise ops.
High-precision finance & business calculations for AI agents — exact decimals, never floats.
Exact arithmetic, algebra, calculus, physics, chemistry and finance with a checkable formula.
Create friendly greetings and add two numbers instantly. Speed up simple tasks and streamline ligh…
Related MCP Servers
- AlicenseDqualityDmaintenanceProvides basic mathematical operations (addition, subtraction, multiplication, division) through a calculate tool. Supports both stdio and HTTP/SSE transport modes.1ISC
- FlicenseNot gradedqualityDmaintenanceEnables basic calculator operations such as add, subtract, multiply, and divide through an MCP interface.-
- AlicenseNot gradedqualityDmaintenanceExposes add, subtract, multiply, and divide tools for performing arithmetic operations over stdio via the Model Context Protocol.ISC
- FlicenseAqualityCmaintenanceEnables 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-