Vibe Math MCP

Um servidor de alto desempenho do Model Context Protocol (MCP) para fazer matemática enquanto curte o momento com LLMs. Construído com Polars, Pandas, NumPy, SciPy e SymPy para velocidade de cálculo otimizada e capacidades matemáticas abrangentes, desde aritmética básica até cálculo avançado e álgebra linear.

GitHub

Documentação

Vibe Math MCP

$PyPI version$ $Python Version$ $Smithery$

Um servidor Model Context Protocol (MCP) de alta performance para fazer matemática enquanto curte com LLMs. Construído com Polars, Pandas, NumPy, SciPy e SymPy para velocidade de cálculo ideal e capacidades matemáticas abrangentes, desde aritmética básica até cálculo avançado e álgebra linear.

Recursos

21 Ferramentas Matemáticas em 6 domínios + orquestração em lote:

Cálculos Básicos (4 ferramentas): Avaliação de expressões, percentuais, arredondamento, conversão de unidades
Operações com Arrays (4 ferramentas): Operações elemento a elemento, estatísticas, agregações, transformações
Estatísticas (3 ferramentas): Estatísticas descritivas, tabelas dinâmicas, correlações
Matemática Financeira (3 ferramentas): Valor do dinheiro no tempo, juros compostos, perpetuidade
Álgebra Linear (3 ferramentas): Operações com matrizes, resolução de sistemas, decomposições
Cálculo (3 ferramentas): Derivadas, integrais, limites e séries
Execução em Lote (1 ferramenta): Orquestração de múltiplas ferramentas para fluxos de trabalho complexos

Instalação

IDEs

Claude Desktop

Abra Configurações > Desenvolvedor > Editar Config e adicione:

Para pacote publicado:

{
  "mcpServers": {
    "Math": {
      "command": "uvx",
      "args": ["vibe-math-mcp"]
    }
  }
}

Para desenvolvimento local:

{
  "mcpServers": {
    "Math": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/vibe-math-mcp",
        "run",
        "vibe-math-mcp"
      ]
    }
  }
}

Claude Code

Configuração rápida (CLI):

Pacote publicado:

claude mcp add --transport stdio math -- uvx vibe-math-mcp

Desenvolvimento local:

claude mcp add --transport stdio math -- uvx --from /absolute/path/to/vibe-math-mcp vibe-math-mcp

Configuração em equipe (crie .mcp.json na raiz do projeto para uso compartilhado com Claude Code e/ou IDEs)

{
  "mcpServers": {
    "math": {
      "command": "uvx",
      "args": ["vibe-math-mcp"]
    }
  }
}

Verificar: Execute claude mcp list ou use /mcp ou visualize os servidores disponíveis nas IDEs.

Experimente

"Calcule 15% de 250" → usa percentage
"Encontre o determinante de [[1,2],[3,4]]" → usa matrix_operations
"Integre x^2 de 0 a 1" → usa integral
"Se eu investir $1000 a 5% de juros anuais compostos mensalmente por 10 anos, qual será o valor futuro?" → usa compound_interest
Se eu recebesse a raiz quadrada de $69m em 10 anos, qual é o valor presente a uma taxa de desconto de 7%? → usa batch_execute (calculate -> financial_calcs)

Controle de Saída

Todas as ferramentas suportam automaticamente o controle de saída para máxima flexibilidade e eficiência de tokens. O LLM pode especificar a verbosidade desejada.

Controle a verbosidade da resposta usando o parâmetro output_mode (disponível em todas as ferramentas):

Modo	Descrição	Economia de Tokens	Caso de Uso
`full`	Resposta completa com todos os metadados (padrão)	0% (linha de base)	Depuração, contexto completo necessário
`compact`	Remove campos nulos, minimiza espaços em branco	~20-30%	Redução moderada, preserva a estrutura
`minimal`	Apenas valor(es) principal(ais), remove metadados	~60-70%	Extração rápida, contexto mínimo
`value`	Estrutura `{value: X}` normalizada	~70-80%	Encadeamento consistente, máxima simplicidade
`final`	Para cadeias sequenciais, retorna apenas o resultado final	~95%	Cálculos simples, extração previsível

Execução em Lote

Para fluxos de trabalho com múltiplas etapas, batch_execute encadeia múltiplos cálculos em uma única solicitação—alcançando 90-95% de redução de tokens. Referencie saídas anteriores usando a sintaxe $operation_id.result, e o mecanismo lida automaticamente com a resolução de dependências e execução paralela para velocidade.

Perfeito para: Precificação de títulos, modelos financeiros, pipelines estatísticos, transformações complexas

Referência Completa de Ferramentas

Observação: Todos os parâmetros das ferramentas incluem descrições detalhadas com exemplos concretos diretamente na interface do MCP. Cada parâmetro mostra o formato esperado, casos de uso e valores de exemplo para tornar o uso óbvio sem consultar documentação externa.

Cálculos Básicos

Ferramenta	Descrição
`calculate`	Avalie expressões matemáticas com substituição de variáveis
`percentage`	Cálculos de porcentagem (de, aumento, diminuição, variação)
`round`	Arredondamento avançado (round, floor, ceil, trunc)
`convert_units`	Conversões de unidades (graus ↔ radianos)

Operações com Arrays

Ferramenta	Descrição
`array_operations`	Operações elemento a elemento (adicionar, subtrair, multiplicar, dividir, potência)
`array_statistics`	Medidas estatísticas (média, mediana, desvio padrão, mínimo, máximo, soma)
`array_aggregate`	Agregações (somatório de produtos, média ponderada, produto escalar)
`array_transform`	Transformações (normalizar, padronizar, escalar, log)

Estatísticas

Ferramenta	Descrição
`statistics`	Análise abrangente (descrever, quartis, outliers)
`pivot_table`	Crie tabelas dinâmicas com agregação
`correlation`	Matrizes de correlação (Pearson, Spearman)

Matemática Financeira

Ferramenta	Descrição
`financial_calcs`	Valor do dinheiro no tempo (VP, VF, PMT, TIR, VPL)
`compound_interest`	Juros compostos com diversas frequências

Álgebra Linear

Ferramenta	Descrição
`matrix_operations`	Operações com matrizes (multiplicar, inversa, transposta, determinante, traço)
`solve_linear_system`	Resolva sistemas Ax = b
`matrix_decomposition`	Decomposições (autovalores, SVD, QR, Cholesky, LU)

Cálculo

Ferramenta	Descrição
`derivative`	Diferenciação simbólica e numérica
`integral`	Integração simbólica e numérica
`limits_series`	Limites e expansões em série


## Development

### Running Tests

```bash
# Install dependencies
uv sync

# Run all tests
uv run poe test

Modos de Desenvolvimento Local

Modo STDIO (padrão - para Claude Desktop, IDEs):

uv run vibe-math-mcp

Modo HTTP (para testes em contêiner):

uv run python -m vibe_math_mcp.http_server

Licença

Licença MIT. Consulte o arquivo LICENSE para detalhes.

Contribuição

Contribuições são bem-vindas via PRs! Por favor, garanta:

Que os testes passem e que novos sejam adicionados quando aplicável
Que o código seja lintado e formatado
Que anotações de tipo (type hints) sejam incluídas
Que mensagens de erro claras e acionáveis sejam fornecidas

Suporte

Para problemas e dúvidas, abra uma issue no GitHub.