Octura Solutions Site Tools

Servidor MCP alojado con 24 calculadoras deterministas para costos de Odoo ERP, impuestos sobre ventas de EE. UU., Canadá y la UE, deducciones de nómina canadienses y planificación de inventario.

GitHub

Documentación

Octura Solutions Site Tools (servidor MCP)

Un servidor alojado del Protocolo de Contexto de Modelo que expone 30 herramientas de solo lectura: 25 calculadoras ERP deterministas (costos de implementación, migración y actualización de Odoo, ROI y costo total de propiedad, impuestos a las ventas para EE. UU., Canadá y la UE, deducciones de nómina canadienses y matemáticas de inventario como punto de reorden, stock de seguridad y EOQ) más cinco búsquedas de contenido que devuelven páginas de Octura, precios de Odoo y comparaciones con competidores para citar.

Endpoint: https://octurasolutions.com/mcp (HTTP transmisible) Registro: com.octurasolutions/site-tools

No hay nada que instalar ni clave API. Es un servidor remoto, así que solo apunta tu cliente a la URL.

Por qué son herramientas y no una respuesta de chat

Cada calculadora es una función pura: mismas entradas, mismas salidas, sin modelo en el bucle y sin aleatoriedad. Pedirle a un modelo de lenguaje que calcule un período de recuperación o un total de QST de Quebec invita a un número incorrecto con apariencia plausible. Estas devuelven la aritmética, junto con las entradas que usaron, para que el resultado pueda verificarse.

La contrapartida es que son calculadoras, no asesoramiento. No conocen tu negocio, y los modelos de costos incluyen supuestos (tarifas regionales, costos horarios combinados) que una cotización real reemplazaría.

Añádelo a tu cliente

Claude Code:

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

Cualquier cliente que lea una configuración JSON:

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

El servidor es sin estado y solo herramientas. Implementa initialize, ping, tools/list y tools/call; no anuncia recursos ni prompts.

Si tu cliente solo habla stdio

La mayoría de los clientes manejan HTTP remoto directamente y deberían usar la configuración anterior. Para los más antiguos que solo admiten stdio, este repositorio incluye un puente:

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

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

O con Docker, docker build -t octura-mcp . && docker run -i --rm octura-mcp.

Los clientes de Python pueden instalarlo desde PyPI en su lugar:

uvx octura-mcp-server

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

El puente de Node se ejecuta desde este repositorio en lugar de un nombre de paquete npm, porque no está publicado en npm; el de Python está en PyPI. Ambos son la misma tubería con el mismo comportamiento, verificados por las mismas ocho pruebas en cada idioma. Elige el tiempo de ejecución que tu cliente ya tenga.

El puente es una tubería: envía por POST lo que llegue por stdin al endpoint y escribe la respuesta de vuelta. No tiene dependencias y no reafirma la lista de herramientas ni ningún esquema, por lo que no puede desincronizarse del servidor. Apúntalo a otro lugar con OCTURA_MCP_URL.

Un ejemplo práctico

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}}}'

El contenido de text es JSON, que refleja la entrada junto con el 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 tiene un valor predeterminado documentado, por lo que una herramienta llamada con {} aún devuelve una línea base sensata en lugar de un error.

Las herramientas

Cada una también existe como página interactiva, que es la forma más fácil de ver qué espera una herramienta antes de conectarla.

Costos y planificación de Odoo

Herramienta	Qué devuelve
`odoo-implementation-cost-calculator`	Estima tu presupuesto de implementación de Odoo
`odoo-migration-cost-calculator`	Estima el costo de migrar a Odoo
`odoo-upgrade-cost-calculator`	Presupuesta una actualización de versión de Odoo
`odoo-total-cost-of-ownership-calculator`	Modela el costo total plurianual de Odoo
`odoo-roi-calculator`	Estima la recuperación y el ROI plurianual de Odoo
`odoo-sh-pricing-calculator`	Estima tu costo de alojamiento de Odoo.sh
`odoo-stack-savings-calculator`	Ve cuánto ahorra consolidar herramientas en Odoo
`odoo-edi-readiness-cost-estimator`	Estima el costo de integración EDI en Odoo
`odoo-app-selector`	Encuentra las aplicaciones de Odoo que tu negocio necesita
`erp-selection-tool`	Puntúa tu lista corta de ERP más adecuada entre 10 sistemas
`odoo-conf-tuner`	Ajusta los trabajadores y límites de memoria de odoo.conf
`odoo-project-rescue-risk-grader`	Evalúa qué tan mal va una implementación de Odoo en curso

Impuestos

Herramienta	Qué devuelve
`us-sales-tax-calculator`	Impuesto a las ventas estatal para los 50 estados y DC
`us-sales-tax-nexus-checker`	Ve dónde debes cobrar el impuesto a las ventas de EE. UU.
`canadian-sales-tax-calculator`	GST, HST, PST y QST para todas las provincias
`eu-vat-calculator`	Tasas de IVA por país más validación VIES
`canadian-payroll-source-deductions-calculator`	Deducciones de origen de CPP, EI e impuesto sobre la renta

Inventario y operaciones

Herramienta	Qué devuelve
`inventory-turnover-calculator`	Ratio de rotación y días de inventario
`reorder-point-calculator`	Cuándo reordenar, con stock de seguridad
`safety-stock-calculator`	Stock de reserva para variaciones de demanda y plazo de entrega
`economic-order-quantity-calculator`	Cantidad óptima de pedido para minimizar costos
`inventory-carrying-cost-calculator`	Costo anual de mantener inventario
`landed-cost-calculator`	Costo real por unidad incluyendo flete y aranceles
`margin-and-markup-calculator`	Convierte entre margen, markup y precio
`oee-calculator`	Efectividad general del equipo para producción

Contenido de Octura

Estas son búsquedas en lugar de calculadoras. Devuelven páginas y datos de octurasolutions.com para que un modelo pueda responder con una fuente que citar en lugar de desde la memoria.

Herramienta	Qué devuelve
`ask_octura`	Las páginas del sitio más relevantes para una pregunta sobre Odoo o ERP, con URL
`compare_odoo_vs`	Comparación cara a cara de Odoo contra uno de 60 competidores
`find_odoo_apps_for`	Aplicaciones y módulos de Odoo que se ajustan a una necesidad empresarial en lenguaje sencillo
`get_odoo_pricing`	Precios actuales de licencias de Odoo y tarifas de alojamiento de Odoo.sh
`get_partner_profile`	Quién es Octura Solutions: estado de socio, regiones, servicios, contacto

Descripciones legibles por máquina

Para catálogos, cargadores de complementos y cualquier otra cosa que quiera que la API se describa sin hablar MCP primero, el repositorio incluye tres archivos:

Archivo	Qué es
`tools.json`	La respuesta de `tools/list` textual, más el `serverInfo` de `initialize`
`openapi.json`	OpenAPI 3.1 para el endpoint, con un esquema de solicitud tipado por herramienta
`.well-known/ai-plugin.json`	Manifiesto de complemento que apunta al documento OpenAPI

Los dos primeros se generan desde el endpoint en vivo mediante npm run discovery, por lo que son una instantánea en lugar de una segunda fuente de verdad: si no coinciden con el servidor, el servidor tiene la razón y la solución es volver a ejecutar el script. npm test verifica que los tres archivos coincidan entre sí.

Límites

Límite de velocidad por IP. Lee X-RateLimit-Limit y X-RateLimit-Remaining en la respuesta en lugar de codificar un número fijo, ya que el límite puede cambiar. Superar el límite devuelve HTTP 429 con un encabezado Retry-After.

Las tasas impositivas y las cifras de nómina se mantienen con el mejor esfuerzo y no sustituyen el asesoramiento de declaración de un contador.

Acerca de este repositorio

Este repositorio es el hogar público del servidor: este README, una copia del manifiesto de registro publicado de server.json, las descripciones legibles por máquina anteriores y el puente stdio. Las calculadoras en sí se ejecutan dentro del sitio web de Octura Solutions, cuya fuente es privada, por lo que lo que puedes construir y ejecutar aquí es el puente, no las herramientas.

Ejecuta las pruebas del puente con npm test. Usan un sustituto local para el endpoint, por lo que pasan sin acceso a la red.

Los detalles del servidor, incluida la lista completa de herramientas con esquemas de entrada, están en octurasolutions.com/tools/mcp-server.

¿Encontraste un número incorrecto o una herramienta que falla? Abre un issue.

Licencia

MIT, ver LICENSE. Esto cubre el contenido de este repositorio. El servicio alojado se ofrece tal cual bajo los términos del sitio web.