MCP server de Punchneedle.ai
Commit 12 nov 2026Convierte imágenes en patrones de punch needle, estima la cantidad de lana necesaria y ofrece orientación sobre la compatibilidad de materiales.
También conocido como pyxlino/punchneedle-mcp, punchneedle-ai
- Stars
- 0
- Herramientas
- 7
- Descargas, 30 días
- —
- Última versión
- 1.0.1
- Último commit
- 12 nov 2026
- Licencia
- —
¿Qué es Punchneedle.ai MCP?
Convierte imágenes en patrones de punch needle, estima la cantidad de lana necesaria y ofrece orientación sobre la compatibilidad de materiales. Expone 7 herramientas, como make_pattern_from_image, find_patterns, get_pattern.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Punchneedle.ai
Este servidor permite a los artistas textiles crear diseños personalizados de punch needle a partir de imágenes personales. Al proporcionar la dirección de una imagen, el ancho final deseado y un límite de colores, los usuarios pueden generar patrones de cuadrícula de puntadas que incluyen los requerimientos específicos de lana para cada color. El servidor se conecta mediante streamable HTTP y no requiere cuenta, inicio de sesión ni API key para su uso en clientes como Claude o ChatGPT.
Los usuarios pueden acceder a una biblioteca de patrones existentes por tema o nivel de dificultad y redimensionar los diseños manteniendo sus proporciones originales. El conjunto de herramientas incluye calculadoras especializadas para estimar las necesidades de lana según las dimensiones, la proporción de colores y la altura del bucle de la aguja. También ofrece comprobaciones de compatibilidad de materiales y orientación detallada sobre agujas, telas como monk's cloth y varios tipos de lana para asegurar que todos los componentes funcionen correctamente.
Qué puedes hacer con él
- 1Generar patrones personalizados desde fotosConvierte una imagen pública en PNG, JPEG o WebP en un patrón detallado de cuadrícula de puntadas.
- 2Estimar las cantidades de lana necesariasCalcula cuánta lana se requiere para un diseño específico basándose en su tamaño y distribución de colores.
- 3Verificar la compatibilidad de materialesComprueba si una aguja, tela y tipo de lana específicos son adecuados para usarse juntos.
- 4Explorar bibliotecas de patrones temáticosEncuentra patrones de punch needle existentes filtrados por temas específicos o niveles de habilidad.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Punchneedle.ai MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Punchneedle.ai MCP en Claude Code
$ claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcpInstalar Punchneedle.ai MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp"
}
}
}Instalar Punchneedle.ai MCP en VS Code
.vscode/mcp.json
{
"servers": {
"punchneedle-ai": {
"type": "http",
"url": "https://punchneedle.ai/api/mcp"
}
}
}Instalar Punchneedle.ai MCP en VS Code CLI
$ code --add-mcp '{"name":"punchneedle-ai","type":"http","url":"https://punchneedle.ai/api/mcp"}'Instalar Punchneedle.ai MCP en Codex
$ codex mcp add punchneedle-ai --url https://punchneedle.ai/api/mcpInstalar Punchneedle.ai MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.punchneedle-ai] url = "https://punchneedle.ai/api/mcp"
Instalar Punchneedle.ai MCP en Gemini CLI
$ gemini mcp add -s user --transport http punchneedle-ai https://punchneedle.ai/api/mcpInstalar Punchneedle.ai MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp",
"type": "http"
}
}
}Herramientas de Punchneedle.ai MCP 7
Detectado desde el READMEmake_pattern_from_imagefind_patternsget_patterncalculate_yarnresize_patternmatch_materialsget_material_guide
| make_pattern_from_image | — | |
| find_patterns | — | |
| get_pattern | — | |
| calculate_yarn | — | |
| resize_pattern | — | |
| match_materials | — | |
| get_material_guide | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblepyxlino/punchneedle-mcp is public and reachablegithub.com/pyxlino/punchneedle-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)No licenseHallazgo
- Commit o lanzamiento en el último añoLast commit or release 2026-11-12github.com/pyxlino/punchneedle-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 272 msAprobado
README
Ver en GitHubPunchneedle.ai MCP app
Make a punch needle pattern from your own image, or pick one from the library.
Give an image address, a finished width and a colour limit and get a stitch-grid pattern with the yarn each colour needs. Ask for patterns by theme, estimate yarn, resize a design or check that your needle, fabric and yarn work together. Answers come from the same pattern converter, calculators and guides as punchneedle.ai.
- Website: https://punchneedle.ai
- Documentation: https://punchneedle.ai/app
- Privacy: https://punchneedle.ai/privacy
- Terms: https://punchneedle.ai/terms
This repository documents the hosted connector. It does not contain the website or its code.
Connect
- Endpoint:
https://punchneedle.ai/api/mcp - Transport: Streamable HTTP
- Authentication: none (no account, sign-in or API key)
{ "mcpServers": { "punchneedle-ai": { "url": "https://punchneedle.ai/api/mcp" } } }
In ChatGPT, add it as a custom MCP server with no authentication. In Claude, open Customize, then Connectors, choose Add custom connector and enter the URL.
Tools
All tools are read-only.
| Tool | What it does |
|---|---|
make_pattern_from_image |
Converts a public PNG, JPEG or WebP image into a punch needle pattern with the website's pattern converter. |
find_patterns |
Lists the original punch needle patterns in the Punchneedle.ai library, filtered by theme and level. |
get_pattern |
Returns one library pattern with its size, colours, making steps, materials and the yarn each colour needs in a fine-wool kit and a rug-wool kit. |
calculate_yarn |
Estimates the yarn for a punch needle design from its size, the share of each colour and the needle and loop height, or from a measured swatch. |
resize_pattern |
Rescales a library pattern, or a design of a given size, to a new width or height with the proportions kept. |
match_materials |
Checks whether a punch needle, a fabric and a yarn work together, using the website's material guidance. |
get_material_guide |
Returns the website's guide to one punch needle material: needles, needle sizes, fabric, monk's cloth, yarn, floss, hoops or glue. |
Try asking
- "Show me punch needle flower patterns."
- "How much yarn do I need for a 30 by 20 cm punch needle piece that is 55% cream, 30% green and 15% gold?"
- "Will an Oxford regular punch needle work with rug yarn on monk's cloth?"
Report an issue
Open an issue in this repository or use the About page at https://punchneedle.ai/about.
License
The documentation files in this repository are MIT licensed (see LICENSE). The Punchneedle.ai website, its content, data and brand are not covered by this license.
Preguntas sobre Punchneedle.ai MCP
¿Cómo agrego Punchneedle.ai MCP a Claude Code?
Ejecuta claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Punchneedle.ai MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Punchneedle.ai MCP?
Expone 7 herramientas, incluidas make_pattern_from_image, find_patterns, get_pattern, calculate_yarn, resize_pattern.
¿Cómo puedo crear un patrón a partir de una imagen?
Puedes proporcionar la dirección de una imagen para convertir un archivo PNG, JPEG o WebP público en un patrón de cuadrícula de puntadas con los requerimientos de lana.
¿Puedo estimar cuánta lana necesito?
Sí, el servidor puede estimar la lana basándose en el tamaño del diseño, la proporción de colores, la altura de la aguja/bucle o una muestra medida.
¿Verifica si mis materiales son compatibles?
Sí, puede comprobar si una aguja, tela y lana específicas funcionan bien juntas utilizando la guía de materiales del sitio web.