MCP server Punchneedle.ai
Коммит 12 нояб. 2026 г.Преобразует изображения в схемы для вышивки контурным крючком (punch needle), рассчитывает расход пряжи и дает рекомендации по совместимости материалов.
Также известен как pyxlino/punchneedle-mcp, punchneedle-ai
- Звёзды
- 0
- Инструменты
- 7
- Загрузки, 30 дней
- —
- Последняя версия
- 1.0.1
- Последний коммит
- 12 нояб. 2026 г.
- Лицензия
- —
Что такое Punchneedle.ai MCP?
Преобразует изображения в схемы для вышивки контурным крючком (punch needle), рассчитывает расход пряжи и дает рекомендации по совместимости материалов. Он предоставляет 7 инструментов, например make_pattern_from_image, find_patterns, get_pattern.
Сводка сгенерирована из README проекта
О Punchneedle.ai MCP server
Этот сервер позволяет мастерам по текстилю создавать индивидуальные дизайны для вышивки контурным крючком на основе личных фотографий. Предоставив ссылку на изображение, желаемую ширину готового изделия и ограничение по количеству цветов, пользователи могут генерировать схемы в виде сетки стежков, которые включают точный расчет расхода пряжи для каждого цвета. Сервер подключается через streamable HTTP и не требует создания аккаунта, входа в систему или использования API ключа при работе в таких клиентах, как Claude или ChatGPT.
Пользователи могут получить доступ к библиотеке готовых схем, отфильтрованных по темам или уровню сложности, а также изменять размер дизайнов с сохранением исходных пропорций. Инструментарий включает специализированные калькуляторы для оценки расхода пряжи на основе размеров, доли цветов и высоты петли иглы. Сервис также предоставляет проверку совместимости материалов и подробные рекомендации по иглам, тканям (например, monk's cloth) и различным типам пряжи, чтобы гарантировать правильное сочетание всех компонентов.
Что вы можете с ним делать
- 1Создание индивидуальных схем из фотоПреобразование публичных изображений PNG, JPEG или WebP в детализированную сетку стежков.
- 2Расчет необходимого количества пряжиВычисление объема пряжи, требуемого для конкретного дизайна, исходя из его размера и распределения цветов.
- 3Проверка совместимости материаловПроверка того, подходят ли выбранные игла, ткань и тип пряжи для совместного использования.
- 4Просмотр тематических библиотек схемПоиск готовых схем для вышивки контурным крючком с фильтрацией по темам или уровням навыков.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Punchneedle.ai MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Punchneedle.ai MCP в Claude Code
$ claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcpУстановка Punchneedle.ai MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp"
}
}
}Установка Punchneedle.ai MCP в VS Code
.vscode/mcp.json
{
"servers": {
"punchneedle-ai": {
"type": "http",
"url": "https://punchneedle.ai/api/mcp"
}
}
}Установка Punchneedle.ai MCP в VS Code CLI
$ code --add-mcp '{"name":"punchneedle-ai","type":"http","url":"https://punchneedle.ai/api/mcp"}'Установка Punchneedle.ai MCP в Codex
$ codex mcp add punchneedle-ai --url https://punchneedle.ai/api/mcpУстановка Punchneedle.ai MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.punchneedle-ai] url = "https://punchneedle.ai/api/mcp"
Установка Punchneedle.ai MCP в Gemini CLI
$ gemini mcp add -s user --transport http punchneedle-ai https://punchneedle.ai/api/mcpУстановка Punchneedle.ai MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp",
"type": "http"
}
}
}Инструменты Punchneedle.ai MCP 7
Определено из 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 | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийpyxlino/punchneedle-mcp is public and reachablegithub.com/pyxlino/punchneedle-mcp ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)No licenseПроблема
- Коммит или релиз за последний годLast commit or release 2026-11-12github.com/pyxlino/punchneedle-mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPinitialize answered with protocol 2025-06-18 in 272 msПройдено
README
Открыть на 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.
Вопросы о Punchneedle.ai MCP
Как добавить Punchneedle.ai MCP в Claude Code?
Выполните claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Punchneedle.ai MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет Punchneedle.ai MCP?
Он предоставляет 7 инструментов, включая make_pattern_from_image, find_patterns, get_pattern, calculate_yarn, resize_pattern.
Как создать схему из изображения?
Вы можете указать ссылку на изображение, чтобы преобразовать публичный файл в формате PNG, JPEG или WebP в сетку стежков с расчетом необходимой пряжи.
Можно ли оценить, сколько мне понадобится пряжи?
Да, сервер может рассчитать расход пряжи на основе размера изделия, распределения цветов, высоты петли иглы или замера образца.
Проверяет ли сервис совместимость материалов?
Да, он может проверить, подходят ли друг другу конкретная игла, ткань и пряжа, используя рекомендации по материалам с сайта.