Calculator MCP Server

Calculator MCP Server

Um servidor MCP baseado em TypeScript que implementa uma calculadora robusta com aritmética decimal precisa. Este servidor demonstra conceitos centrais do MCP ao fornecer operações aritméticas com suporte para múltiplos operandos e precisão configurável usando Decimal.js.

Recursos

Ferramentas

Funções Aritméticas

Estas funções recebem um array de pelo menos dois números e retornam um único resultado numérico.

• add - Soma um array de números.
• subtract - Subtrai números sequencialmente a partir do primeiro.
• multiply - Multiplica um array de números.
• divide - Divide números sequencialmente. Trata divisão por zero.

Funções Trigonométricas

Estas funções operam em arrays de números e retornam um array de resultados. A entrada angles requer pelo menos um número.

• Trigonometria Básica: sin, cos, tan
  • Entrada: angles (array de números), mode ('radianos' ou 'graus', padrão é 'radianos').
• Trigonometria Inversa: asin, acos, atan
  • Entrada: values (array de números).
• Funções Hiperbólicas: sinh, cosh, tanh
  • Entrada: values (array de números).
• Funções Hiperbólicas Inversas: asinh, acosh, atanh
  • Entrada: values (array de números).

Diversos

• set_precision - Configura a precisão decimal para todos os cálculos subsequentes.
  • Recebe o parâmetro precision como o número de casas decimais.

Desenvolvimento

Instale as dependências:

bun install

Execute o servidor de desenvolvimento:

bun start

Instalação como servidor MCP autônomo

Para usar com Claude Desktop, adicione a configuração do servidor:

No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json No Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "Calculator": {
      "command": "/path/to/calculator-mcp/src/index.ts"
    }
  }
}

Ou para a extensão Cline VSCode, adicione uma versão modificada disto ao seu arquivo de configuração MCP:

   "Calculator": {
      "autoApprove": [
        "add",
        "subtract",
        "multiply",
        "divide",
        "set_precision"
      ],
      "disabled": true,
      "timeout": 60,
      "type": "stdio",
      "command": "bun",
      "args": [
        "/path-to-your/calculator-mcp/src/index.ts"
      ]
    }

Instalação usando Docker

Para executar o servidor MCP usando Docker, você deve primeiro construir a imagem usando:

docker build -t calculator-mcp .

Seguido pela adição disto ao arquivo de configuração MCP (Cline):

    "Calculator (docker)": {
      "autoApprove": [
        "add",
        "subtract",
        "multiply",
        "divide",
        "set_precision"
      ],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "calculator-mcp"
      ]
    }

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o MCP Inspector, que está disponível como um script de pacote:

bun run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.