Octura Solutions Site Tools

Servidor MCP hospedado com 24 calculadoras determinísticas para custos do Odoo ERP, impostos sobre vendas dos EUA, Canadá e UE, deduções de folha de pagamento canadense e planejamento de inventário.

GitHubExperimente este MCPPatrocinado

Documentação

Octura Solutions Site Tools (servidor MCP)

Um servidor Model Context Protocol hospedado que expõe 24 calculadoras ERP determinísticas: implementação Odoo, custos de migração e upgrade, ROI e custo total de propriedade, imposto sobre vendas para os EUA, Canadá e UE, deduções de folha de pagamento canadenses e matemática de inventário como ponto de reabastecimento, estoque de segurança e LEC.

Endpoint: https://octurasolutions.com/mcp (HTTP transmissível) Registro: com.octurasolutions/site-tools

Nada para instalar e nenhuma chave de API. É um servidor remoto, então você aponta seu cliente para a URL.

Por que são ferramentas e não uma resposta de chat

Cada ferramenta é uma função pura: mesmas entradas, mesmas saídas, sem modelo no processo e sem aleatoriedade. Pedir a um modelo de linguagem para calcular um período de retorno ou um total de QST de Quebec convida a um número errado com aparência plausível. Estas retornam a aritmética, junto com as entradas que usaram, para que o resultado possa ser verificado.

A compensação é que são calculadoras, não conselhos. Elas não conhecem o seu negócio, e os modelos de custo carregam premissas (taxas regionais, custos horários combinados) que uma cotação real substituiria.

Adicione ao seu cliente

Claude Code:

claude mcp add --transport http octura https://octurasolutions.com/mcp

Qualquer cliente que leia uma configuração JSON:

{
  "mcpServers": {
    "octura": {
      "type": "streamable-http",
      "url": "https://octurasolutions.com/mcp"
    }
  }
}

O servidor é sem estado e apenas ferramentas. Ele implementa initialize, ping, tools/list e tools/call; não anuncia recursos nem prompts.

Se o seu cliente só fala stdio

A maioria dos clientes lida com HTTP remoto diretamente e deve usar a configuração acima. Para os mais antigos que só suportam stdio, este repositório inclui uma ponte:

npx -y github:Octura-solutions/octura-mcp-server

{
  "mcpServers": {
    "octura": {
      "command": "npx",
      "args": ["-y", "github:Octura-solutions/octura-mcp-server"]
    }
  }
}

Ou com Docker, docker build -t octura-mcp . && docker run -i --rm octura-mcp.

Clientes Python podem instalá-lo do PyPI:

uvx octura-mcp-server

{
  "mcpServers": {
    "octura": {
      "command": "uvx",
      "args": ["octura-mcp-server"]
    }
  }
}

A ponte Node roda a partir deste repositório em vez de um nome de pacote npm, porque não está publicada no npm; a Python está no PyPI. Ambas são o mesmo pipe com o mesmo comportamento, verificado pelos mesmos oito testes em cada linguagem. Escolha o runtime que seu cliente já possui.

A ponte é um pipe: ela envia via POST o que chega no stdin para o endpoint e escreve a resposta de volta. Não tem dependências e não reafirma a lista de ferramentas ou qualquer esquema, então não pode sair de sincronia com o servidor. Aponte-a para outro lugar com OCTURA_MCP_URL.

Um exemplo prático

curl -s -X POST https://octurasolutions.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"odoo-roi-calculator",
        "arguments":{"currentAnnualCost":60000,"odooAnnualCost":18000,
                     "implementationCost":45000,"annualEfficiencySavings":30000}}}'

O conteúdo de text é JSON, ecoando a entrada junto com o resultado:

{
  "tool": "odoo-roi-calculator",
  "input": {
    "currentAnnualCost": 60000,
    "odooAnnualCost": 18000,
    "implementationCost": 45000,
    "annualEfficiencySavings": 30000
  },
  "result": {
    "annualNetSavings": 72000,
    "paybackMonths": 7.5,
    "threeYearNet": 171000,
    "threeYearRoiPercent": 380
  }
}

Cada entrada tem um padrão documentado, então uma ferramenta chamada com {} ainda retorna uma linha de base sensata em vez de um erro.

As ferramentas

Cada uma também existe como uma página interativa, que é a maneira mais fácil de ver o que uma ferramenta espera antes de conectá-la.

Custo e planejamento Odoo

Ferramenta	O que retorna
`odoo-implementation-cost-calculator`	Estime seu orçamento de implementação Odoo
`odoo-migration-cost-calculator`	Estime o custo de migrar para Odoo
`odoo-upgrade-cost-calculator`	Orce um upgrade de versão Odoo
`odoo-total-cost-of-ownership-calculator`	Modele o custo total plurianual do Odoo
`odoo-roi-calculator`	Estime o retorno e o ROI plurianual do Odoo
`odoo-sh-pricing-calculator`	Estime seu custo de hospedagem Odoo.sh
`odoo-stack-savings-calculator`	Veja o que consolidar ferramentas no Odoo economiza
`odoo-edi-readiness-cost-estimator`	Estime o custo de integração EDI no Odoo
`odoo-app-selector`	Encontre os aplicativos Odoo que seu negócio precisa
`erp-selection-tool`	Pontue sua lista de ERP mais adequada em 10 sistemas
`odoo-conf-tuner`	Ajuste workers e limites de memória do odoo.conf

Impostos

Ferramenta	O que retorna
`us-sales-tax-calculator`	Imposto sobre vendas estadual para todos os 50 estados e DC
`us-sales-tax-nexus-checker`	Veja onde você deve cobrar imposto sobre vendas nos EUA
`canadian-sales-tax-calculator`	GST, HST, PST e QST para todas as províncias
`eu-vat-calculator`	Alíquotas de IVA por país mais validação VIES
`canadian-payroll-source-deductions-calculator`	Deduções de fonte de CPP, EI e imposto de renda

Inventário e operações

Ferramenta	O que retorna
`inventory-turnover-calculator`	Índice de rotatividade e dias de inventário
`reorder-point-calculator`	Quando reabastecer, com estoque de segurança
`safety-stock-calculator`	Estoque de segurança para variações de demanda e lead time
`economic-order-quantity-calculator`	Quantidade ideal de pedido para minimizar custo
`inventory-carrying-cost-calculator`	Custo anual de manter inventário
`landed-cost-calculator`	Custo real por unidade incluindo frete e imposto
`margin-and-markup-calculator`	Converta entre margem, markup e preço
`oee-calculator`	Eficácia Geral do Equipamento para produção

Limites

Limite de taxa por IP. Leia X-RateLimit-Limit e X-RateLimit-Remaining na resposta em vez de codificar um número, já que o teto pode mudar. Acima do limite retorna HTTP 429 com um cabeçalho Retry-After.

As alíquotas de impostos e valores de folha de pagamento são mantidos com base no melhor esforço e não substituem conselhos de declaração de um contador.

Sobre este repositório

Este repositório é o lar público do servidor: este README, uma cópia do manifesto de registro server.json publicado e a ponte stdio descrita acima. As calculadoras em si rodam dentro do site Octura Solutions, cujo código-fonte é privado, então o que você pode construir e executar aqui é a ponte, não as ferramentas.

Execute os testes da ponte com npm test. Eles usam um substituto local para o endpoint, então passam sem acesso à rede.

Detalhes sobre o servidor, incluindo a lista completa de ferramentas com esquemas de entrada, estão em octurasolutions.com/tools/mcp-server.

Encontrou um número errado ou uma ferramenta que dá erro? Abra uma issue.

Licença

MIT, veja LICENSE. Isso cobre o conteúdo deste repositório. O serviço hospedado é oferecido como está sob os termos do site.