Calculator MCP Server (Python)

Многофункциональный Model Context Protocol (MCP) сервер для математических вычислений, научных функций, конвертации единиц измерения, финансовых показателей и статистического анализа.

Создан на Python 3.10+ с использованием официального mcp SDK (FastMCP) и sympy. Поддерживает оба режима транспорта: stdio (Claude Desktop) и sse (Claude Web / Remote HTTP Connectors).

🚀 Возможности и доступные инструменты

• evaluate_math_expression: Вычисляет пользовательские математические выражения безопасно с помощью SymPy (например, 2 * (3 + 4), sqrt(144) + sin(pi / 2), log(100, 10), 5^3).

• perform_arithmetic: Базовые арифметические операции (add, subtract, multiply, divide) над массивами чисел.

• scientific_calculation: Степени, корни (sqrt, cbrt), факториалы, логарифмы (log, ln) и тригонометрические функции (sin, cos, tan).

• convert_unit: Конвертация физических единиц измерения (длина, масса/вес, температура, объём, время).

• financial_calculator: Простой процент, сложный процент, расчёт EMI по кредиту и проценты.

• calculate_statistics: Сводная статистика (mean, median, mode, variance, stdev, summary).

Related MCP server: MCP Mathematics

📦 Установка и настройка

1. Установка зависимостей: GXP1

2. Запуск автоматических модульных тестов: GXP2

💻 1. Подключение к Claude Desktop (Stdio Mode)

claude_desktop_config.json автоматически создан по адресу: C:\Users\ADMIN\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "calculator": {
      "command": "C:\\Users\\ADMIN\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
      "args": [
        "-m",
        "calculator_mcp.server"
      ],
      "env": {
        "PYTHONPATH": "E:/mcp tutorials"
      }
    }
  }
}

Использование в Claude Desktop:

1. Полностью выйдите из Claude Desktop и перезапустите его.

2. Откройте чат и найдите 🔨 (значок молотка/инструментов) в правом нижнем углу панели сообщений.

3. Спросите Claude: «Сколько будет sqrt(144) + sin(pi / 2)?» или «Переведи 100 degC в degF».

🌐 2. Подключение к Claude Web и удалённым веб-клиентам (SSE HTTP Mode)

Чтобы запустить Calculator MCP как веб-HTTP-сервис (для веб-платформ, веб-коннекторов или удалённых ИИ-агентов):

1. Запустите SSE веб-сервер: GXP4

2. Конфигурация веб-клиента: GXP5

3. Публичный туннель для удалённых веб-приложений (опционально): Если ваш веб-клиент (например, удалённый Claude Web) размещён за пределами вашей локальной сети, откройте порт 8000 с помощью ngrok или localtunnel: GXP6

   Затем используйте сгенерированный публичный HTTPS URL: https://<your-subdomain>.loca.lt/sse в конфигурации вашего Web MCP коннектора.

🔍 Интерактивное тестирование через веб-интерфейс (MCP Inspector)

Вы можете запустить официальный интерактивный веб-интерфейс Model Context Protocol Inspector, чтобы визуально протестировать все инструменты в вашем браузере:

mcp dev calculator_mcp/server.py

Или через Node:

npx @modelcontextprotocol/inspector@0.4.1 python -m calculator_mcp.server