# Tekneh 붙이기

Tekneh는 SIGGRAPH와 SIGGRAPH Asia 아트 페이퍼 229편에서 작품을 어떻게 만들었는지를 정리해 둔 MCP 서버입니다. Cursor에 붙이면 AI가 내 아이디어와 비슷한 선례를 찾아 주고, 계획서에서 빠지기 쉬운 칸을 질문으로 짚어 줍니다.

[제작 계획서](https://opencircuit.club/wiki/plan)의 안내서가 처음에 Tekneh 연결까지 해 줍니다. 이 페이지는 따로 붙이고 싶거나, 안내서로 연결이 안 됐을 때 씁니다.

설치는 두 단계입니다. `uv`라는 프로그램을 한 번 깔고, `mcp.json`에 몇 줄을 적습니다. MCP를 붙이는 방법 자체는 [Cursor에 서버 붙이기](https://opencircuit.club/wiki/mcp/setup)과 같습니다.

## 1. uv 설치

터미널에 아래 한 줄을 붙여 넣습니다. 이미 깔려 있으면 건너뜁니다.

맥은 터미널에서:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

윈도우는 PowerShell에서:

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```

설치가 끝나면 **Cursor를 완전히 껐다 켭니다.** 새로 깐 프로그램을 Cursor가 찾으려면 재시작이 필요합니다.

## 2. mcp.json에 추가

작업 폴더의 `.cursor/mcp.json`을 열고 `mcpServers` 안에 `tekneh` 항목을 넣습니다. 파일이 없으면 새로 만들고 아래를 그대로 붙여 넣습니다.

```json
{
  "mcpServers": {
    "tekneh": { "command": "uvx", "args": ["tekneh"] }
  }
}
```

이미 다른 서버가 있으면 그 줄 뒤에 쉼표를 찍고 `tekneh` 줄을 더합니다.

**Cursor Settings → MCP**에서 `tekneh`가 초록 불로 뜨면 연결된 것입니다. 처음 켤 때 자료를 내려받느라 몇십 초 걸릴 수 있습니다.

## 3. 확인

채팅에서 한 번 물어봅니다.

```text
Tekneh로 "사람이 다가가면 소리가 나는 설치"와 비슷한 선례를 lang="ko"로 세 편만 찾아 줘.
```

도구를 쓰겠다고 물으면 **Run**을 누릅니다. 작품 이름과 링크가 나오면 됩니다. 이제 [제작 계획서](https://opencircuit.club/wiki/plan)로 돌아가 이어 쓰면 됩니다.

## 읽을 때 주의할 점

Tekneh가 보여 주는 것은 논문에 **적힌 것**입니다. "논문에 적히지 않음"이라고 나오면 그 작품에 그것이 없었다는 뜻이 아닙니다. 작가가 논문에 쓰지 않았다는 뜻입니다.

선례는 참고용입니다. SIGGRAPH에 실린 작품들이 좋은 작품의 기준은 아닙니다. 논문 원문은 대부분 영어이고, 링크를 열면 ACM 사이트로 갑니다. 제목과 요약만 봐도 충분합니다.

예산, 운송, 회로 고장처럼 논문에 적히지 않는 것은 Tekneh가 답하지 못합니다. 그런 것은 [막힐 때](https://opencircuit.club/wiki/stuck)의 방법대로 물어봐 주세요.

## 초록 불이 안 뜰 때

맥에서 `uvx`를 찾지 못한다는 에러가 나면 `command`에 전체 경로를 적습니다. 터미널에서 `which uvx`를 치면 나오는 경로입니다.

```json
{
  "mcpServers": {
    "tekneh": { "command": "/Users/내이름/.local/bin/uvx", "args": ["tekneh"] }
  }
}
```

윈도우는 PowerShell에서 `where.exe uvx`로 경로를 찾고, 역슬래시를 두 번씩 적습니다. 예: `"C:\\Users\\내이름\\.local\\bin\\uvx.exe"`.

그래도 안 되면 에러 화면을 캡처해서 보내 주세요.