Metadata-Version: 2.4
Name: hueflow-sketchup-mcp
Version: 0.1.1
Summary: SketchUp을 Claude/Cursor/Gemini에 연결하는 MCP 서버 (한국어 강의용 / SketchUp 2024-2026 호환)
Project-URL: Homepage, https://github.com/hueflowstudio/hueflow-sketchup-mcp
Project-URL: Repository, https://github.com/hueflowstudio/hueflow-sketchup-mcp
Project-URL: Issues, https://github.com/hueflowstudio/hueflow-sketchup-mcp/issues
Project-URL: Original Project, https://github.com/Tarkiin/SketchUp-MCP
Author-email: Hueflow Studio <hueflow.studio@gmail.com>
License: MIT
License-File: LICENSE
Keywords: 3d-modeling,ai,architecture,claude,interior,korean,mcp,sketchup
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Korean
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

﻿# Hueflow SketchUp MCP

> **SketchUp??Claude AI???곌껐?섎뒗 MCP ?쒕쾭 (?쒓뎅??/ SketchUp 2024-2026 吏??**
>
> ?댄뵆濡쒖슦 ?ㅽ뒠?붿삤???명뀒由ъ뼱 + AI 媛뺤쓽?⑹쑝濡??쒓뎅?댄솕쨌?ы뙣?ㅼ쭠??踰꾩쟾?낅땲??
> Claude?먭쾶 "嫄곗떎??3x3x2.5m 諛?留뚮뱾?댁쨾"?쇨퀬 留먰븯硫?SketchUp???ㅼ젣濡?紐⑤뜽??留뚮벊?덈떎.

[![PyPI](https://img.shields.io/pypi/v/hueflow-sketchup-mcp)](https://pypi.org/project/hueflow-sketchup-mcp/)
[![SketchUp](https://img.shields.io/badge/SketchUp-2024%20%7C%202025%20%7C%202026-orange)]()
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

---

## ??鍮좊Ⅸ ?ㅼ튂 (3?④퀎)

### 1截뤴깵 SketchUp ?뚮윭洹몄씤 ?ㅼ튂

[Releases ?섏씠吏](https://github.com/hueflowstudio/hueflow-sketchup-mcp/releases/latest)?먯꽌 **`hueflow_sketchup_mcp.rbz`** ?ㅼ슫濡쒕뱶.

SketchUp ?ㅽ뻾 ??**李?Window) ???뺤옣 愿由ъ옄(Extension Manager) ???뺤옣 ?ㅼ튂(Install Extension)** ???ㅼ슫諛쏆? .rbz ?뚯씪 ?좏깮.

?ㅼ튂 ?꾨즺 ??SketchUp ?ъ떆??

### 2截뤴깵 Claude Desktop ?ㅼ젙

**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

???뚯씪??硫붾え?μ쑝濡??댁뼱???ㅼ쓬 ?댁슜 異붽?:

```json
{
  "mcpServers": {
    "hueflow-sketchup": {
      "command": "uvx",
      "args": ["hueflow-sketchup-mcp"]
    }
  }
}
```

> ?뮕 **`uv`媛 ?ㅼ튂?섏뼱 ?덉뼱???⑸땲??** PowerShell?먯꽌 `where.exe uv` ?낅젰?댁꽌 寃쎈줈媛 ?섏삤硫?OK.
> ?놁쑝硫? `winget install --id=astral-sh.uv -e` ?ㅽ뻾.

### 3截뤴깵 ?ㅽ뻾

1. **SketchUp ?ㅽ뻾** ???먮룞?쇰줈 ?쒕쾭媛 8080 ?ы듃?먯꽌 ?쒖옉??2. **Claude Desktop ?ㅽ뻾**
3. Claude?먭쾶 紐낅졊: *"?ㅼ?移섏뾽??媛濡?3誘명꽣 ?몃줈 4誘명꽣 ?믪씠 2.5誘명꽣 諛?留뚮뱾?댁쨾"*

?쒕쾭媛 ?먮룞?쇰줈 ??耳쒖?硫?SketchUp 硫붾돱?먯꽌 **?뺤옣(Plugins) ??Hueflow MCP ?쒕쾭 ???쒕쾭 ?쒖옉** ?대┃.

---

## ?렞 ?????덈뒗 寃?(21媛吏 ?꾧뎄)

| 遺꾨쪟 | 紐낅졊 ?덉떆 |
|------|----------|
| **紐⑤뜽 ?뺣낫** | "?꾩옱 紐⑤뜽???대뼡 而댄룷?뚰듃???덉뼱?" |
| **諛뺤뒪 ?앹꽦** | "1.2x0.6x0.75m 梨낆긽 留뚮뱾?댁쨾" |
| **????* | "諛섏?由?50cm ??洹몃젮以? |
| **?몄떆?** | "??硫?1m 諛?댁쨾" |
| **?ъ쭏 ?곸슜** | "踰쎌뿉 ?곗깋 ?섏씤??移좏빐以? |
| **?대룞/?뚯쟾/?ㅼ???* | "洹?而댄룷?뚰듃 90???뚮젮以? |
| **吏遺??몃윭??* | "8m ??뿉 ?뱁룷?ㅽ듃 ?몃윭??留뚮뱾?댁쨾" |
| **Ruby 肄붾뱶 ?ㅽ뻾** | 怨좉툒 ?ъ슜?먯슜 |

---

## ?좑툘 ?뚮젮吏??쒓퀎

- **SketchUp 臾대즺 踰꾩쟾(??釉뚮씪?곗? 踰꾩쟾)?먯꽌???묐룞 ????** ?곗뒪?ы깙 SketchUp Pro ?꾩슂.
- ?쇰? 蹂듭옟???묒뾽? ?쒓컙??嫄몃┫ ???덉쓬 (??꾩븘??120珥?.
- **?ы듃 8080**???ㅻⅨ ?꾨줈洹몃옩?먯꽌 ?ъ슜 以묒씠硫???耳쒖쭚.

---

## ?㈉ 臾몄젣 ?닿껐

### "SketchUp???곌껐?????놁뒿?덈떎"
1. SketchUp???ㅽ뻾 以묒씤吏 ?뺤씤
2. 硫붾돱 ???뺤옣 ??Hueflow MCP ?쒕쾭 ???쒕쾭 ?곹깭 ?뺤씤
3. ?ы듃 8080 ?먯쑀 ?щ?: PowerShell?먯꽌 `netstat -an | findstr 8080`

### "uvx瑜?李얠쓣 ???놁뒿?덈떎"
- `uv`媛 ?ㅼ튂 ???? PowerShell?먯꽌:
  ```
  winget install --id=astral-sh.uv -e
  ```
- ?ㅼ튂 ??**而댄벂???ъ떆??* (PATH ?곸슜)

### ?뚮윭洹몄씤??SketchUp????蹂댁뿬??- ?뺤옣 愿由ъ옄?먯꽌 ?쒖꽦???곹깭 ?뺤씤
- SketchUp ?꾩쟾 醫낅즺 ???ъ떆??- Ruby 肄섏넄(李???Ruby 肄섏넄)?먯꽌 ?먮윭 硫붿떆吏 ?뺤씤

### ?붾쾭洹?濡쒓렇 ?꾩튂
- **Windows**: `%TEMP%\sketchup_mcp_debug.log`
- **macOS**: `/tmp/sketchup_mcp_debug.log`

---

## ?뱴 媛뺤쓽 ?먮즺

???⑦궎吏???ㅼ쓬 媛뺤쓽?먯꽌 ?ъ슜?⑸땲??

- **紐⑺룷 嫄댁텞?ы쉶** AI ?ㅻТ 媛뺤쥖 (6?뚯감)
- **?쒖넄 ?꾩뭅?곕?** AI 留덉뒪?고겢?섏뒪
- **Fastcampus** AI ?명뀒由ъ뼱 媛뺤쓽

媛뺤쓽 臾몄쓽: [@hueflow_studio](https://www.instagram.com/hueflow_studio/)

---

## ?솋 ?щ젅??
???꾨줈?앺듃???ㅼ쓬 ?ㅽ뵂?뚯뒪 ?꾨줈?앺듃瑜?湲곕컲?쇰줈 ?⑸땲??

- **[Tarkiin/SketchUp-MCP](https://github.com/Tarkiin/SketchUp-MCP)** ???먮낯 肄붾뱶 (MIT License)
- **[mhyrr/sketchup-mcp](https://github.com/mhyrr/sketchup-mcp)** ??理쒖큹 SketchUp MCP 而⑥뀎 (MIT License)

?쒓뎅?댄솕 / ?ы뙣?ㅼ쭠 / 媛뺤쓽??媛?대뱶 ?묒꽦 짤 2026 Hueflow Studio.

## ?뱶 ?쇱씠?좎뒪

MIT License. ?먯꽭???댁슜? [LICENSE](LICENSE) 李몄“.

