Punchneedle.ai MCP server
2026년 11월 12일 커밋이미지를 펀치 니들 패턴으로 변환하고, 필요한 실의 양을 추정하며, 재료 호환성 가이드를 제공합니다.
다른 이름 pyxlino/punchneedle-mcp, punchneedle-ai
- 스타
- 0
- Tools
- 7
- 다운로드, 30일
- —
- 최신 버전
- 1.0.1
- 마지막 커밋
- 2026년 11월 12일
- 라이선스
- —
Punchneedle.ai MCP란?
이미지를 펀치 니들 패턴으로 변환하고, 필요한 실의 양을 추정하며, 재료 호환성 가이드를 제공합니다. 7개 도구를 제공합니다. 예: make_pattern_from_image, find_patterns, get_pattern.
프로젝트 README에서 생성된 요약
Punchneedle.ai MCP server 정보
이 MCP server는 섬유 예술가들이 개인 이미지를 활용해 맞춤형 펀치 니들 디자인을 제작할 수 있도록 지원합니다. 이미지 주소, 원하는 완성 너비, 색상 제한을 입력하면 각 색상별 실 소요량이 포함된 스티치 그리드 패턴을 생성할 수 있습니다. 이 server는 streamable HTTP를 통해 연결되며, Claude 또는 ChatGPT와 같은 클라이언트에서 사용할 때 별도의 계정, 로그인 또는 API key가 필요하지 않습니다.
사용자는 테마나 난이도별로 구성된 기존 패턴 라이브러리에 접속할 수 있으며, 원래 비율을 유지하면서 디자인 크기를 조정할 수 있습니다. 도구 모음에는 크기, 색상 비율, 바늘 루프 높이를 기반으로 실 소요량을 추정하는 전문 계산기가 포함되어 있습니다. 또한 재료 호환성 확인 기능과 함께 바늘, 몽크스 클로스(monk's cloth)와 같은 원단, 다양한 실 종류에 대한 상세 가이드를 제공하여 모든 구성 요소가 올바르게 작동하도록 돕습니다.
활용 사례
- 1사진으로 맞춤형 패턴 생성공개된 PNG, JPEG 또는 WebP 이미지를 상세한 스티치 그리드 패턴으로 변환합니다.
- 2필요한 실의 양 추정디자인의 크기와 색상 분포를 바탕으로 특정 디자인에 필요한 실의 양을 계산합니다.
- 3재료 호환성 확인특정 바늘, 원단, 실 종류가 함께 사용하기에 적합한지 확인합니다.
- 4테마별 패턴 라이브러리 탐색특정 테마나 숙련도에 따라 필터링된 기존 펀치 니들 패턴을 찾아봅니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Punchneedle.ai MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Punchneedle.ai MCP 설치
$ claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcpCursor에 Punchneedle.ai MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp"
}
}
}VS Code에 Punchneedle.ai MCP 설치
.vscode/mcp.json
{
"servers": {
"punchneedle-ai": {
"type": "http",
"url": "https://punchneedle.ai/api/mcp"
}
}
}VS Code CLI에 Punchneedle.ai MCP 설치
$ code --add-mcp '{"name":"punchneedle-ai","type":"http","url":"https://punchneedle.ai/api/mcp"}'Codex에 Punchneedle.ai MCP 설치
$ codex mcp add punchneedle-ai --url https://punchneedle.ai/api/mcpCodex config.toml에 Punchneedle.ai MCP 설치
~/.codex/config.toml
[mcp_servers.punchneedle-ai] url = "https://punchneedle.ai/api/mcp"
Gemini CLI에 Punchneedle.ai MCP 설치
$ gemini mcp add -s user --transport http punchneedle-ai https://punchneedle.ai/api/mcpGemini settings.json에 Punchneedle.ai MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp",
"type": "http"
}
}
}Punchneedle.ai MCP 도구 7
README에서 감지됨make_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 | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능pyxlino/punchneedle-mcp is public and reachablegithub.com/pyxlino/punchneedle-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)No license결함 발견
- 최근 1년 내 커밋 또는 릴리스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통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 272 ms통과
README
GitHub에서 보기Punchneedle.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 이미지를 실 소요량이 포함된 스티치 그리드 패턴으로 변환할 수 있습니다.
필요한 실의 양을 추정할 수 있나요?
네, 디자인 크기, 색상 비율, 바늘/루프 높이 또는 측정된 스와치를 기반으로 실의 양을 추정할 수 있습니다.
재료가 서로 호환되는지 확인해 주나요?
네, 웹사이트의 재료 가이드를 사용하여 특정 바늘, 원단, 실이 서로 잘 맞는지 확인할 수 있습니다.