Punchneedle.ai MCP server
Commit 12 Nov 2026Mengonversi gambar menjadi pola punch needle, mengestimasi kebutuhan benang, dan memberikan panduan kompatibilitas material.
Juga dikenal sebagai pyxlino/punchneedle-mcp, punchneedle-ai
- Stars
- 0
- Tools
- 7
- Unduhan, 30 hari
- —
- Versi terbaru
- 1.0.1
- Commit terakhir
- 12 Nov 2026
- Lisensi
- —
Apa itu Punchneedle.ai MCP?
Mengonversi gambar menjadi pola punch needle, mengestimasi kebutuhan benang, dan memberikan panduan kompatibilitas material. Server ini menyediakan 7 tool, seperti make_pattern_from_image, find_patterns, get_pattern.
Ringkasan dibuat dari README proyek
Tentang Punchneedle.ai MCP server
Server ini memungkinkan para seniman fiber untuk membuat desain punch needle kustom dari foto pribadi. Dengan memberikan alamat gambar, lebar hasil akhir yang diinginkan, dan batas warna, pengguna dapat menghasilkan pola stitch-grid yang mencakup kebutuhan benang spesifik untuk setiap warna. Server ini terhubung via streamable HTTP dan tidak memerlukan akun, login, atau API key untuk digunakan pada client seperti Claude atau ChatGPT.
Pengguna dapat mengakses pustaka pola yang sudah ada berdasarkan tema atau tingkat kesulitan, serta mengubah ukuran desain sambil tetap mempertahankan proporsi aslinya. Toolset ini mencakup kalkulator khusus untuk mengestimasi kebutuhan benang berdasarkan dimensi, proporsi warna, dan tinggi loop jarum. Alat ini juga menyediakan pengecekan kompatibilitas material dan panduan mendalam mengenai jarum, kain seperti monk's cloth, dan berbagai jenis benang untuk memastikan semua komponen dapat bekerja bersama dengan benar.
Apa yang bisa Anda lakukan dengannya
- 1Generate pola kustom dari fotoKonversi gambar PNG, JPEG, atau WebP publik menjadi pola stitch-grid yang mendetail.
- 2Estimasi jumlah benang yang diperlukanHitung berapa banyak benang yang dibutuhkan untuk desain tertentu berdasarkan ukuran dan distribusi warnanya.
- 3Verifikasi kompatibilitas materialCek apakah jarum, kain, dan jenis benang tertentu cocok untuk digunakan bersama.
- 4Telusuri pustaka pola bertemaTemukan pola punch needle yang sudah ada dengan filter tema atau tingkat keahlian tertentu.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Punchneedle.ai MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Punchneedle.ai MCP di Claude Code
$ claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcpInstal Punchneedle.ai MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp"
}
}
}Instal Punchneedle.ai MCP di VS Code
.vscode/mcp.json
{
"servers": {
"punchneedle-ai": {
"type": "http",
"url": "https://punchneedle.ai/api/mcp"
}
}
}Instal Punchneedle.ai MCP di VS Code CLI
$ code --add-mcp '{"name":"punchneedle-ai","type":"http","url":"https://punchneedle.ai/api/mcp"}'Instal Punchneedle.ai MCP di Codex
$ codex mcp add punchneedle-ai --url https://punchneedle.ai/api/mcpInstal Punchneedle.ai MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.punchneedle-ai] url = "https://punchneedle.ai/api/mcp"
Instal Punchneedle.ai MCP di Gemini CLI
$ gemini mcp add -s user --transport http punchneedle-ai https://punchneedle.ai/api/mcpInstal Punchneedle.ai MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"punchneedle-ai": {
"url": "https://punchneedle.ai/api/mcp",
"type": "http"
}
}
}Tool Punchneedle.ai MCP 7
Terdeteksi dari 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 | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaupyxlino/punchneedle-mcp is public and reachablegithub.com/pyxlino/punchneedle-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-12github.com/pyxlino/punchneedle-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 272 msLolos
README
Lihat di 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.
Pertanyaan tentang Punchneedle.ai MCP
Bagaimana cara menambahkan Punchneedle.ai MCP ke Claude Code?
Jalankan claude mcp add --transport http punchneedle-ai https://punchneedle.ai/api/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Punchneedle.ai MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan Punchneedle.ai MCP?
Server ini menyediakan 7 tool, termasuk make_pattern_from_image, find_patterns, get_pattern, calculate_yarn, resize_pattern.
Bagaimana cara membuat pola dari sebuah gambar?
Anda dapat memberikan alamat gambar untuk mengonversi gambar PNG, JPEG, atau WebP publik menjadi pola stitch-grid lengkap dengan kebutuhan benang.
Bisakah saya mengestimasi berapa banyak benang yang saya butuhkan?
Ya, server ini dapat mengestimasi benang berdasarkan ukuran desain, proporsi warna, tinggi jarum/loop, atau sampel (swatch) yang telah diukur.
Apakah alat ini mengecek apakah material saya kompatibel?
Ya, alat ini dapat mengecek apakah jarum, kain, dan benang tertentu dapat digunakan bersama menggunakan panduan material dari website terkait.