Punchneedle.ai MCPサーバー
コミット 2026年11月12日画像をパンチニードルのパターンに変換し、必要な毛糸の量を推定、素材の適合性に関するガイダンスを提供します。
別名 pyxlino/punchneedle-mcp, punchneedle-ai
- スター
- 0
- ツール
- 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は、ファイバーアーティストが個人の画像からカスタムのパンチニードルデザインを作成することを可能にします。画像のURL、希望する仕上がりの幅、色の制限を指定することで、各色の具体的な毛糸の必要量を含むステッチグリッドパターンを生成できます。このserverはstreamable HTTP経由で接続され、ClaudeやChatGPTなどのクライアントで使用する際に、アカウント作成やサインイン、APIキーは必要ありません。
ユーザーは、テーマや難易度別に既存のパターンライブラリにアクセスでき、元の比率を維持したままデザインのサイズを変更できます。ツールセットには、寸法、色の割合、針のループの高さに基づいて毛糸の必要量を推定する専用の計算機が含まれています。また、素材の適合性チェックや、針、モンクス・クロスなどの布、さまざまな種類の毛糸に関する詳細なガイダンスを提供し、すべてのコンポーネントが正しく組み合わされるようにサポートします。
できること
- 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Punchneedle.ai MCPが提供するツールは
7個のツールを提供しており、make_pattern_from_image, find_patterns, get_pattern, calculate_yarn, resize_patternなどがあります。
画像からパターンを作成するにはどうすればよいですか?
画像のURLを指定することで、公開されているPNG、JPEG、またはWebP形式の画像を、毛糸の必要量を含むステッチグリッドパターンに変換できます。
必要な毛糸の量を推定できますか?
はい。デザインのサイズ、色の割合、針やループの高さ、または測定したスウォッチに基づいて、毛糸の量を推定できます。
素材の適合性を確認できますか?
はい。ウェブサイトの素材ガイダンスを使用して、特定の針、布、毛糸が組み合わせて使用可能かどうかを確認できます。