stitchmath-mcp

Calculadoras profesionales de matemáticas para tejer y hacer crochet que permiten a la IA diseñar patrones con medidas perfectas.

GitHub

Documentación

🧶 StitchMath Core (stitchmath-core)

Official Website License: MIT TypeScript Ready

🏆 Destacado y Aprobado En

Product Hunt    Approved on SaaSHub

StitchMath Core es el motor de cálculo matemático de código abierto y el repositorio de conjuntos de datos estandarizados de StitchMath.com. Diseñado para desarrolladores, diseñadores y blogueros de manualidades, esta biblioteca elimina las conjeturas en el tejido de punto y crochet al proporcionar algoritmos robustos para el ajuste de calibre, disminuciones uniformes en filas, clasificación de hilo WPI y conversiones internacionales de tamaños de agujas.

[!IMPORTANT] 🌟 ¿Necesitas la Suite Web Interactiva Completa y el Asistente de IA?
Este repositorio contiene nuestro SDK algorítmico ligero y conjuntos de datos públicos. Para la experiencia visual completa—incluyendo más de 20 calculadoras interactivas, nuestro Generador de Patrones de Suéter personalizado y el Asistente de Patrones con IA—visita la aplicación web oficial en https://stitchmath.com.

🆚 SDK de Código Abierto vs. Plataforma StitchMath.com

Característicastitchmath-core (Este Repositorio)Plataforma Oficial StitchMath.com
Algoritmos Matemáticos Principales (SDK JS/TS)✅ Sí (Funciones Crudas)✅ Sí (Visual e Interactivo)
Conjuntos de Datos JSON Estandarizados✅ Sí (Agujas, Hilo WPI, Mantas)✅ Sí (Tablas Interactivas)
Más de 20 Calculadoras Web Visuales❌✅ Sí (Calibre, Calcetines, Mangas, etc.)
Asistente de Patrones con IA❌✅ Sí (Resolución Instantánea de Ajuste con IA)
Generador de Patrones de Suéter Personalizado❌✅ Sí (Dimensionamiento Dinámico de Prendas)
Guías Imprimibles y Tutoriales de Muestras❌✅ Sí (Centro de Referencia Integral)

👉 Experimenta todas las herramientas interactivas gratis en StitchMath.com →

📦 Características y Conjuntos de Datos

  • 📏 Algoritmo de Conversión de Calibre: Ajusta los conteos de puntos del patrón con precisión según las medidas reales de la muestra.
  • ➕ Espaciado de Aumentos y Disminuciones: Calcula automáticamente la distribución uniforme de puntos y genera instrucciones de trabajo por filas (k2tog, m1).
  • ⚖️ Conjuntos de Datos JSON Curados: Archivos JSON estandarizados y legibles por máquina para:
    • Tamaños de Agujas (data/needle-sizes.json): Conversiones completas de EE. UU., Reino Unido/Canadá y métricas (mm).
    • Pesos de Hilo y WPI (data/yarn-weights.json): Clasificaciones estándar 0–6, rangos de vueltas por pulgada y equivalentes de hebras del Reino Unido/Australia.
    • Dimensiones Estándar (data/blanket-sizes.json): Tamaños estándar para mantas, mantas de bebé, bufandas y calcetines.
  • 🌐 Independiente de Unidades: Conversión bidireccional fluida entre el sistema imperial de EE. UU. (in, oz, yd) y el métrico (cm, g, m).
  • 🔷 Soporte Completo de TypeScript: Incluye declaraciones de tipos integrales (src/index.d.ts).

🤖 Servidor de Protocolo de Contexto de Modelo (MCP)

StitchMath Core ahora incluye un servidor MCP integrado, que permite a asistentes de IA como Claude Desktop y Cursor realizar matemáticas de tejido 100% precisas, conversiones de calibre y cálculos de dimensionamiento directamente en tus chats.

Herramientas de IA Disponibles

El servidor expone las siguientes herramientas a los LLM:

  • calculate_gauge: Ajusta los conteos de puntos con precisión según las medidas reales de la muestra.
  • calculate_even_spacing: Calcula aumentos o disminuciones espaciados uniformemente a lo largo de una fila.
  • convert_needle_size: Convierte entre tamaños de agujas de EE. UU., Reino Unido y métricos.
  • convert_units: Convierte dimensiones imperiales/métricas.
  • get_blanket_cast_on: Obtén puntos de montaje recomendados para tamaños estándar de mantas.

Instalación en Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "stitchmath": {
      "command": "npx",
      "args": ["-y", "stitchmath-core"]
    }
  }
}

🚀 Inicio Rápido (Para Desarrolladores)

Instalación

Puedes instalar stitchmath-core mediante npm o yarn en tus proyectos de Node.js, React, Vue o React Native:

npm install stitchmath-core

Ejemplos de Uso

1. Calcular el Ajuste de Calibre

Cuando un patrón requiere 20 puntos sobre 4 pulgadas, pero tu muestra real es de 22 puntos sobre 4 pulgadas:

const { calculateGauge } = require('stitchmath-core');

// How many stitches should you cast on for a 36-inch bust?
const castOnStitches = calculateGauge(22, 4, 36);
console.log(`Cast on ${castOnStitches} stitches`); // Output: Cast on 198 stitches

2. Calcular Disminuciones Uniformes en una Fila

Cuando das forma a una manga o a la corona de un gorro y necesitas disminuir 8 puntos uniformemente en un total de 80 puntos:

const { calculateEvenSpacing } = require('stitchmath-core');

const shaping = calculateEvenSpacing(80, 8, true); // true = decrease
console.log(shaping.instructions);
// Output: Work 9 sts, then [k2tog (or decrease), work 9 sts] across the row.

3. Consultar Tamaños de Agujas y Conversiones

const { convertNeedleSize } = require('stitchmath-core');

const sizeInfo = convertNeedleSize('8', 'us');
console.log(sizeInfo);
// Output: { mm: '5.0', us: '8', uk: '6' }

📊 Conjuntos de Datos JSON Estandarizados

Puedes importar nuestros conjuntos de datos industriales curados directamente sin importar las funciones de cálculo:

// Import needle chart dataset directly
const needleChart = require('stitchmath-core/data/needle-sizes.json');

// Import yarn weight classifications and WPI standards
const yarnChart = require('stitchmath-core/data/yarn-weights.json');

// Import standard blanket and scarf dimensions
const blanketDimensions = require('stitchmath-core/data/blanket-sizes.json');

🌐 Integración de StitchMath en tu Blog o Sitio Web

¿Eres bloguero de manualidades, diseñador de patrones o autor de tutoriales de tejido? ¡Te animamos a referenciar e integrar StitchMath en tus artículos!

Para agregar un enlace directo o una insignia a la suite de cálculo oficial en tu sitio web, simplemente copia el siguiente fragmento HTML:

<!-- StitchMath Badge & Link -->
<a href="https://stitchmath.com" target="_blank" rel="noopener noreferrer" style="display:inline-block;padding:10px 20px;background:#10b981;color:#fff;text-decoration:none;border-radius:25px;font-weight:bold;box-shadow:0 4px 10px rgba(16,185,129,0.3);">
  🧶 Powered by StitchMath Calculators →
</a>

Al enlazar a StitchMath.com, ayudas a tus lectores a calcular muestras de calibre y dimensionamiento exactas sin salir de su navegador.

🤝 Contribuciones

¡Damos la bienvenida a contribuciones de compañeros desarrolladores, tejedores y crocheteros!

  1. Haz un fork del repositorio.
  2. Crea tu rama de características (git checkout -b feature/amazing-calculation).
  3. Haz commit de tus cambios (git commit -m 'Add new sock heel shaping formula').
  4. Haz push a la rama (git push origin feature/amazing-calculation).
  5. Abre una Solicitud de Extracción (Pull Request).

📄 Licencia

Este repositorio está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

Hecho con ❤️ por el equipo tecnológico de manualidades en StitchMath.com.
Haciendo que las matemáticas del tejido y crochet sean simples para los artesanos de todo el mundo.