Metadata-Version: 2.4
Name: myeongpil-mcp
Version: 0.1.6
Summary: Myeongpil — delegate repetitive Unity-editor work from your AI agent to a low-cost specialized operator model
Project-URL: Homepage, https://myeongpil.14dimension.com
Project-URL: Console, https://myeongpil.14dimension.com/console
Project-URL: Documentation, https://myeongpil.14dimension.com/llms.txt
Project-URL: API Reference, https://myeongpil.14dimension.com/docs
Author-email: 14Dimension <admin@14dimension.com>
License: MIT
Keywords: ai-agent,claude,codex,mcp,unity
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.10
Requires-Dist: mcp<2,>=1.2.0
Description-Content-Type: text/markdown

# 명필 MCP 심 (Myeongpil MCP shim)

<!-- mcp-name: io.github.leegod/myeongpil-mcp -->

> Codex, 2026-08-04: 이 숨은 표식은 공식 MCP Registry가 PyPI 패키지 소유권을 검증할 때
> 사용합니다. `server.json`의 `name`과 반드시 같아야 하므로 릴리스 검사기가 대조합니다.

클로드·코덱스가 반복적인 유니티 에디터 작업을 **명필**(저가 특화 오퍼레이터 모델)에 위임할 수 있게 하는 로컬 MCP 서버입니다.

## 왜 로컬에서 도는가

명필은 여러분 PC의 **유니티 에디터를 직접 조작**합니다. 이 심이 루프를 로컬에서 돌리기 때문에
에이전트는 "이 작업 맡겨줘" 한 번만 말하면 되고, 16번의 왕복이 에이전트 토큰을 소모하지 않습니다.
(에이전트가 매 스텝을 중계하면 그 토큰을 다 쓰게 되어 위임의 이점이 사라집니다.)

## 설치 없이 실행

```
uvx myeongpil-mcp
```

유니티 MCP를 설치하면 `uv`가 함께 깔리므로 별도 설치가 필요 없습니다.

## 필요 환경변수

| 변수 | 설명 |
|---|---|
| `MYEONGPIL_API_KEY` | https://myeongpil.14dimension.com/console 에서 발급 |
| `MYEONGPIL_API_URL` | 기본값 `https://myeongpil.14dimension.com` |
| `UNITY_MCP_CMD` | 유니티 MCP 실행 명령(현재 필수) |

`UNITY_MCP_CMD` 예시는 유니티 MCP 설치 위치에 맞게 콘솔이 생성합니다. 과거 README의
“자동 감지 실패 시에만” 설명은 실제 구현보다 낙관적이었고, 0.1.6부터 명확히 바로잡았습니다.

## 제공 도구와 데이터 경계

- `delegate_unity_task(goal, max_steps, unity_instance)` — 범위가 명확한 반복 Unity 작업을 로컬 에디터에 실행합니다.
- Unity 프로젝트와 에셋은 사용자 PC에 남습니다.
- 목표·도구 호출 이력·짧은 실행 결과는 다음 단계를 결정하기 위해 명필 API로 전송됩니다.
- 실제 프로젝트를 변경하므로 반드시 버전 관리가 된 작업 트리에서 사용하세요.

## 빠른 확인

```bash
uvx myeongpil-mcp
```

MCP 클라이언트에서 `delegate_unity_task`가 보이면 패키지가 정상 기동한 것입니다. 실제 위임에는
`MYEONGPIL_API_KEY`, `MYEONGPIL_API_URL`, `UNITY_MCP_CMD` 세 환경변수가 필요합니다.

문서: <https://myeongpil.14dimension.com/llms.txt> · API: <https://myeongpil.14dimension.com/docs>

## 등록 방법

콘솔에서 여러분 키가 채워진 명령을 복사해 쓰세요 — https://myeongpil.14dimension.com/console
