crochet-engine

crochetpatterngen-engine

crochetpatterngen.comを支える、写真からかぎ針編み図を作成する決定論的なエンジンです。Python ライブラリ、CLI、MCP サーバーとしてパッケージ化されており、AI エージェント（Claude Desktop、Cursor など）が写真から正確な目数のかぎ針編み図を作成できます。

生成型ではなく、決定論的です。 画像を AI で生成する機能はありません。画像のサイズ変更、メディアンカットによる色の量子化、細かなノイズの除去のみを行います。同じ入力からは、毎回同じ図と同じ目数が得られます。存在しない段が作られることはありません。

このエンジンを選ぶ理由

• 正確な目数 — すべての図に、色ごとの HEX 値と目数が含まれ、その合計はグリッドのサイズと正確に一致します。図に見えるものを、そのまま編めます。
• C2C ブロックの縦横比補正 — C2C ブロックは、縦より横のほうが物理的に幅広です（縦：横＝0.7：1）。編み上がりがつぶれず、写真の比率を保てるよう、エンジンがグリッドの寸法を調整します。
• 5 種類の技法プリセット — graph、c2c、tapestry、mosaic、filet。
• 毛糸の使用量を推定 — 6 種類の毛糸の太さ（極細から極太まで）について、色ごとの必要量を推定します。
• 重い依存関係は不要 — Pillow と numpy のみを使用します。背景除去にはオプションの rembg を利用できます。

インストール

pip install crochetpatterngen-engine          # core
pip install crochetpatterngen-engine[mcp]     # + MCP server
pip install crochetpatterngen-engine[rembg]   # + background removal

Python API

from PIL import Image
from crochet_chart_engine import generate_chart, render_design, estimate_yarn

png_bytes, meta = generate_chart(
    Image.open("photo.jpg"),
    technique="c2c",     # graph | c2c | tapestry | mosaic | filet
    grid_w=60,           # 20..120
    n_colors=8,          # 2..16
)
# meta: {"grid_w", "grid_h", "colors": [{"hex", "count"}],
#        "total_stitches", "technique", "warning"}

yarn = estimate_yarn(meta, weight="worsted")
# {"total_yards": ..., "colors": [{"hex", "count", "yards"}], ...}

png_bytes, meta = render_design("designs/frog.txt")  # ASCII design -> chart

CLI

crochet-chart chart photo.jpg out.png --technique c2c --grid-w 60 --colors 8
crochet-chart design designs/frog.txt frog.png
crochet-chart yarn photo.jpg --technique graph --weight worsted

MCP サーバー（Claude Desktop など）

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "crochet": {
      "command": "uvx",
      "args": ["--from", "crochetpatterngen-engine[mcp]", "crochetpatterngen-mcp"]
    }
  }
}

通常の pip インストールを使う場合：

{
  "mcpServers": {
    "crochet": {
      "command": "python",
      "args": ["-m", "crochet_chart_engine.mcp_server"]
    }
  }
}

公開されるツール（stdio トランスポート）：

ツール	機能
photo_to_chart	ローカル画像のパス → 図の PNG（base64 または output_path に保存）＋色ごとの目数を含む JSON
render_ascii_design	ASCII デザインファイル → 図の PNG ＋目数
estimate_yarn_tool	目数 → 1 種類の毛糸の太さ、または all を指定した場合の色ごとの毛糸の必要量

ASCII デザイン形式

designs/frog.txt と designs/dragon.txt を参照してください。

# comment
palette: G=#58A05C, W=#FFFFFF, .=#FAFAF7
title: Frog Face
technique: graph
---
..GGGG..........GGGG....
.GGWWGG........GGWWGG...

1 文字が 1 目に相当します。. は背景／余白の色です。各段は最も長い段の長さに合わせて埋められます。

開発

pip install -e .[dev,mcp]
pytest tests/

ライセンス

MIT — LICENSE を参照してください。

---

無料のウェブツールと編み図ライブラリは crochetpatterngen.com で利用できます。