calculator-mcp-server

Публичный сервер: https://calculator.caseyjhand.com/mcp

Инструменты

Один инструмент для всех математических операций:

calculate

Один инструмент, покрывающий 100% назначения сервера. Параметр operation по умолчанию равен evaluate, поэтому обычный случай — просто { expression: "..." }.

• Evaluate — арифметика, тригонометрия, логарифмы, статистика, матрицы, комплексные числа, преобразование единиц, комбинаторика

• Simplify — символьное упрощение алгебраических выражений (например, 2x + 3x -> 5 * x). Поддерживает алгебраические и тригонометрические тождества

• Derivative — вычисление символьных производных (например, 3x^2 + 2x + 1 -> 6 * x + 2)

• Область переменных через параметр scope: { "x": 5, "y": 3 }

• Настраиваемая точность числовых результатов

• Пустые необязательные значения variable и precision из клиентов MCP на основе форм считаются опущенными

Related MCP server: pycodemath

Ресурсы

Возможности

Построен на @cyanheads/mcp-ts-core:

• Декларативные определения инструментов — один файл на инструмент, фреймворк обрабатывает регистрацию и валидацию

• Единая обработка ошибок для всех инструментов

• Структурированное логирование с опциональной трассировкой OpenTelemetry

• Работает локально (stdio/HTTP) или в Docker

Специфично для калькулятора:

• Усиленный экземпляр math.js v15 — опасные функции отключены, выполнение изолировано через vm.runInNewContext() с таймаутом

• Аутентификация не требуется — все операции только для чтения и без сохранения состояния

• Проверка ввода: ограничение длины выражения, отклонение разделителей выражений (точки с запятой и переводы строк), только числовые значения области

• Проверка результата: заблокированные типы результатов (функции, парсеры, наборы результатов), настраиваемый максимальный размер результата

• Очистка области: только числовые значения, предотвращение загрязнения прототипа (заблокированы __proto__, constructor и т.д.)

Начало работы

Публичный размещённый экземпляр

Публичный экземпляр доступен по адресу https://calculator.caseyjhand.com/mcp — установка не требуется. Подключите любой MCP-клиент к нему через Streamable HTTP:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "streamable-http",
      "url": "https://calculator.caseyjhand.com/mcp"
    }
  }
}

Самостоятельное размещение / Локально

Добавьте одну из следующих строк в файл конфигурации вашего MCP-клиента:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["@cyanheads/calculator-mcp-server@latest"]
    }
  }
}

Или с помощью npx (Bun не требуется):

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cyanheads/calculator-mcp-server@latest"]
    }
  }
}

Или с помощью Docker:

{
  "mcpServers": {
    "calculator-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MCP_TRANSPORT_TYPE=stdio",
        "ghcr.io/cyanheads/calculator-mcp-server:latest"
      ]
    }
  }
}

Предварительные требования

• Bun v1.3.0 или выше

Установка

1. Клонируйте репозиторий:

git clone https://github.com/cyanheads/calculator-mcp-server.git

2. Перейдите в каталог:

cd calculator-mcp-server

3. Установите зависимости:

bun install

Конфигурация

См. .env.example для дополнительных настроек сеанса, возобновляемости, логирования и телеметрии.

Запуск сервера

Локальная разработка

• Соберите и запустите производственную версию:

  bun run build
  bun run start:http   # or start:stdio

• Запустите проверки и тесты:

  bun run devcheck     # Lints, formats, type-checks
  bun run test         # Runs test suite

Docker

docker build -t calculator-mcp-server .
docker run -p 3010:3010 calculator-mcp-server

Образ по умолчанию использует Streamable HTTP на порту 3010, сеансы без сохранения состояния и журналы в /var/log/calculator-mcp-server.

Структура проекта

Руководство по разработке

См. AGENTS.md или CLAUDE.md для руководства по разработке и архитектурных правил. Краткая версия:

• Обработчики выбрасывают исключения, фреймворк перехватывает — никаких try/catch в логике инструментов

• Используйте ctx.log для логирования

• Регистрируйте новые инструменты и ресурсы в src/index.ts

Вклад

Приветствуются issues и pull request'ы. Запустите проверки перед отправкой:

bun run devcheck
bun run test

Лицензия

Apache-2.0 — см. LICENSE для подробностей.