Tekneh 붙이기
Tekneh 붙이기
Tekneh는 SIGGRAPH와 SIGGRAPH Asia 아트 페이퍼 229편에서 작품을 어떻게 만들었는지를 정리해 둔 MCP 서버입니다. Cursor에 붙이면 AI가 내 아이디어와 비슷한 선례를 찾아 주고, 계획서에서 빠지기 쉬운 칸을 질문으로 짚어 줍니다.
제작 계획서의 안내서가 처음에 Tekneh 연결까지 해 줍니다. 이 페이지는 따로 붙이고 싶거나, 안내서로 연결이 안 됐을 때 씁니다.
설치는 두 단계입니다. uv라는 프로그램을 한 번 깔고, mcp.json에 몇 줄을 적습니다. MCP를 붙이는 방법 자체는 Cursor에 서버 붙이기과 같습니다.
1. uv 설치
터미널에 아래 한 줄을 붙여 넣습니다. 이미 깔려 있으면 건너뜁니다.
맥은 터미널에서:
curl -LsSf https://astral.sh/uv/install.sh | sh
윈도우는 PowerShell에서:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
설치가 끝나면 Cursor를 완전히 껐다 켭니다. 새로 깐 프로그램을 Cursor가 찾으려면 재시작이 필요합니다.
2. mcp.json에 추가
작업 폴더의 .cursor/mcp.json을 열고 mcpServers 안에 tekneh 항목을 넣습니다. 파일이 없으면 새로 만들고 아래를 그대로 붙여 넣습니다.
{
"mcpServers": {
"tekneh": { "command": "uvx", "args": ["tekneh"] }
}
}
이미 다른 서버가 있으면 그 줄 뒤에 쉼표를 찍고 tekneh 줄을 더합니다.
Cursor Settings → MCP에서 tekneh가 초록 불로 뜨면 연결된 것입니다. 처음 켤 때 자료를 내려받느라 몇십 초 걸릴 수 있습니다.
3. 확인
채팅에서 한 번 물어봅니다.
Tekneh로 "사람이 다가가면 소리가 나는 설치"와 비슷한 선례를 lang="ko"로 세 편만 찾아 줘.
도구를 쓰겠다고 물으면 Run을 누릅니다. 작품 이름과 링크가 나오면 됩니다. 이제 제작 계획서로 돌아가 이어 쓰면 됩니다.
읽을 때 주의할 점
Tekneh가 보여 주는 것은 논문에 적힌 것입니다. "논문에 적히지 않음"이라고 나오면 그 작품에 그것이 없었다는 뜻이 아닙니다. 작가가 논문에 쓰지 않았다는 뜻입니다.
선례는 참고용입니다. SIGGRAPH에 실린 작품들이 좋은 작품의 기준은 아닙니다. 논문 원문은 대부분 영어이고, 링크를 열면 ACM 사이트로 갑니다. 제목과 요약만 봐도 충분합니다.
예산, 운송, 회로 고장처럼 논문에 적히지 않는 것은 Tekneh가 답하지 못합니다. 그런 것은 막힐 때의 방법대로 물어봐 주세요.
초록 불이 안 뜰 때
맥에서 uvx를 찾지 못한다는 에러가 나면 command에 전체 경로를 적습니다. 터미널에서 which uvx를 치면 나오는 경로입니다.
{
"mcpServers": {
"tekneh": { "command": "/Users/내이름/.local/bin/uvx", "args": ["tekneh"] }
}
}
윈도우는 PowerShell에서 where.exe uvx로 경로를 찾고, 역슬래시를 두 번씩 적습니다. 예: "C:\\Users\\내이름\\.local\\bin\\uvx.exe".
그래도 안 되면 에러 화면을 캡처해서 보내 주세요.