stitchmath-mcp

Calculadoras profissionais de matemática para tricô e crochê que permitem que a IA projete padrões perfeitamente dimensionados.

GitHub

Documentação

🧶 StitchMath Core (stitchmath-core)

Official Website License: MIT TypeScript Ready

🏆 Em Destaque e Aprovado Em

Product Hunt    Approved on SaaSHub

StitchMath Core é o mecanismo de cálculo matemático de código aberto e o repositório de conjuntos de dados padronizados da StitchMath.com. Desenvolvido para desenvolvedores, designers e blogueiros de artesanato, esta biblioteca elimina suposições no tricô e no crochê, fornecendo algoritmos robustos para dimensionamento de amostras, diminuições uniformes em carreiras, classificação de fios por WPI e conversões internacionais de tamanhos de agulhas.

[!IMPORTANT] 🌟 Precisa do Conjunto Completo de Ferramentas Web Interativas e Assistente de IA?
Este repositório contém nosso SDK algorítmico leve e conjuntos de dados públicos. Para a experiência visual completa—incluindo 20+ calculadoras interativas, nosso Gerador de Padrões de Suéter personalizado e o Assistente de Padrões com IA—visite o aplicativo web oficial em https://stitchmath.com.

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

Recursostitchmath-core (Este Repositório)Plataforma Oficial StitchMath.com
Algoritmos Matemáticos Principais (SDK JS/TS)✅ Sim (Funções Brutas)✅ Sim (Visual e Interativo)
Conjuntos de Dados JSON Padronizados✅ Sim (Agulhas, Fios WPI, Cobertores)✅ Sim (Tabelas Interativas)
20+ Calculadoras Web Visuais❌✅ Sim (Amostra, Meias, Mangas, etc.)
Assistente de Padrões com IA❌✅ Sim (Resolução Instantânea de Ajuste com IA)
Gerador de Padrões de Suéter Personalizado❌✅ Sim (Dimensionamento Dinâmico de Vestuário)
Guias Imprimíveis e Tutoriais de Amostras❌✅ Sim (Centro de Referência Abrangente)

👉 Experimente todas as ferramentas interativas gratuitamente no StitchMath.com →

📦 Recursos e Conjuntos de Dados

  • 📏 Algoritmo de Conversão de Amostra: Ajuste com precisão as contagens de pontos do padrão com base nas medidas reais da amostra.
  • ➕ Espaçamento de Aumentos e Diminuições: Calcule automaticamente a distribuição uniforme de pontos e gere instruções de trabalho em carreiras (k2tog, m1).
  • ⚖️ Conjuntos de Dados JSON Curados: Arquivos JSON padronizados e legíveis por máquina para:
    • Tamanhos de Agulhas (data/needle-sizes.json): Conversões abrangentes para EUA, Reino Unido/Canadá e métrico (mm).
    • Pesos de Fios e WPI (data/yarn-weights.json): Classificações padrão de 0 a 6, faixas de Wraps Per Inch e equivalentes em Ply do Reino Unido/Austrália.
    • Dimensões Padrão (data/blanket-sizes.json): Tamanhos padrão para mantas, cobertores de bebê, cachecóis e meias.
  • 🌐 Independente de Unidade: Conversão bidirecional perfeita entre o sistema imperial dos EUA (in, oz, yd) e o métrico (cm, g, m).
  • 🔷 Suporte Completo a TypeScript: Inclui declarações de tipos abrangentes (src/index.d.ts).

🤖 Servidor Model Context Protocol (MCP)

O StitchMath Core agora inclui um servidor MCP integrado, permitindo que assistentes de IA como Claude Desktop e Cursor realizem cálculos de tricô 100% precisos, conversões de amostra e cálculos de dimensionamento diretamente em seus chats.

Ferramentas de IA Disponíveis

O servidor expõe as seguintes ferramentas para LLMs:

  • calculate_gauge: Ajuste com precisão as contagens de pontos com base nas medidas reais da amostra.
  • calculate_even_spacing: Calcule aumentos ou diminuições uniformemente espaçados em uma carreira.
  • convert_needle_size: Converta entre tamanhos de agulhas dos EUA, Reino Unido e métrico.
  • convert_units: Converta dimensões imperiais/métricas.
  • get_blanket_cast_on: Obtenha pontos de montagem recomendados para tamanhos padrão de cobertores.

Instalação no Claude Desktop

Adicione o seguinte ao seu claude_desktop_config.json:

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

🚀 Início Rápido (Para Desenvolvedores)

Instalação

Você pode instalar o stitchmath-core via npm ou yarn em seus projetos Node.js, React, Vue ou React Native:

npm install stitchmath-core

Exemplos de Uso

1. Calcular Ajuste de Amostra

Quando um padrão pede 20 pontos em 4 polegadas, mas sua amostra real tem 22 pontos em 4 polegadas:

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 Diminuições Uniformes em uma Carreira

Ao modelar uma manga ou o topo de um chapéu e você precisar diminuir 8 pontos uniformemente em um total de 80 pontos:

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 Tamanhos de Agulhas e Conversões

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

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

📊 Conjuntos de Dados JSON Padronizados

Você pode importar nossos conjuntos de dados industriais curados diretamente, sem importar as funções 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');

🌐 Incorporando StitchMath no Seu Blog ou Site

Você é um blogueiro de artesanato, designer de padrões ou autor de tutoriais de tricô? Encorajamos você a referenciar e incorporar o StitchMath em seus artigos!

Para adicionar um link direto ou selo para o conjunto oficial de cálculos em seu site, basta copiar o seguinte trecho de 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>

Ao vincular ao StitchMath.com, você ajuda seus leitores a calcular amostras de tensão exatas e dimensionamento sem sair do navegador!

🤝 Contribuindo

Aceitamos contribuições de colegas desenvolvedores, tricoteiros e crocheteiros!

  1. Faça um fork do repositório.
  2. Crie seu branch de recurso (git checkout -b feature/amazing-calculation).
  3. Faça commit das suas alterações (git commit -m 'Add new sock heel shaping formula').
  4. Envie para o branch (git push origin feature/amazing-calculation).
  5. Abra um Pull Request.

📄 Licença

Este repositório está licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Feito com ❤️ pela equipe de tecnologia de artesanato em StitchMath.com.
Tornando a matemática de tricô e crochê simples para artesãos em todo lugar.