calc_mcp
calc_mcp
MCP-сервис калькулятора, предоставляющий через stdio четыре арифметические операции: сложение, вычитание, умножение и деление.
Использует API FastMCP из официального MCP Python SDK; зависимости ограничены версией 1.x, чтобы избежать изменений интерфейса при обновлении между основными версиями.
Доступные инструменты
Все инструменты принимают два обязательных числовых параметра — a и b; поддерживаются целые числа, десятичные дроби и отрицательные числа.
Инструмент | Операция | Пример аргументов вызова | Результат |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
При успешном вызове structuredContent равен {"result": 数值}; также возвращается совместимое текстовое содержимое. Инструменты не читают и не записывают файлы и не обращаются к сети.
Ошибки возвращаются в результате инструмента MCP с isError: true и не прерывают работу сервиса:
Делитель равен
0или-0.0:Cannot divide by zero.Аргумент равен NaN или бесконечности:
Operands must be finite numbers.Результат переполняется, превращаясь в бесконечность:
Result exceeds the supported finite number range.Отсутствуют аргументы или передано значение, которое невозможно разобрать как число: SDK возвращает ошибку проверки параметров.
Вычисления используют числа с плавающей запятой двойной точности Python, поэтому возможны обычные ошибки округления; например, 0.1 + 0.2 может вернуть 0.30000000000000004. Сервис не предназначен для сценариев, требующих точных десятичных вычислений; данная версия не поддерживает вычисление выражений.
Related MCP server: My Calculator MCP Server
Структура каталога
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 集成测试Установка и запуск
Требуются Python 3.10+ и uv. Выполните в каталоге проекта:
uv sync
uv run calc-mcpТакже можно запустить через точку входа модуля:
uv run python -m calc_mcpСервис взаимодействует с MCP-клиентом через стандартный ввод/вывод и не предоставляет веб-интерфейс. После прямого запуска ожидание сообщений от клиента — нормальное явление. Не выводите отладочную информацию в stdout; журналы следует записывать в stderr.
Пример конфигурации MCP-клиента
Нижеприведённое подходит для клиентов, использующих формат JSON-конфигурации mcpServers; адаптируйте под конкретного клиента:
{
"mcpServers": {
"calc-mcp": {
"command": "uv",
"args": [
"--directory",
"/Users/lifang/product/0826/calc_mcp",
"run",
"calc-mcp"
]
}
}
}Если клиент не находит uv, замените command на абсолютный путь к исполняемому файлу uv. После перемещения проекта необходимо обновить путь к каталогу.
Проверка
uv run python -m unittest discover -s tests -vТесты охватывают четыре арифметических действия, отрицательные числа, десятичные дроби, ноль, недопустимые аргументы, неконечные числа и переполнение; также запускается реальный дочерний процесс stdio для проверки инициализации MCP, обнаружения инструментов, вызова инструментов и корректного вызова после ошибки.
Места для дальнейшего расширения
Добавляйте определения инструментов в src/calc_mcp/tools.py и включайте функции в список регистрации register_tools(). create_server() из server.py единообразно регистрирует все инструменты.
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-