원클릭으로 Manus에서 모든 스킬 실행

pinmate-mcp

스타0

포크0

업데이트2026년 6월 24일 13:41

핀메이트(PinMate) 카카오 MCP 서버의 빌드·로컬 검증·컨테이너·대회 등록을 한 절차로 몬다. server/mcp.ts(Streamable HTTP·stateless·도구 5종)를 건드린 뒤 호출하면 `pnpm mcp:smoke`로 14항목(도구·체인·딥링크·SLA·동시성)을 실호출 검증하고, Docker(amd64)·카카오 PlayMCP 등록 체크리스트까지 안내한다. 트리거 — "MCP 테스트", "MCP 배포", "대회 신청/등록", "스모크", server/ 수정 후, "/pinmate-mcp".

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

Jason-hub-star

Jason-hub-star/codegate

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

pinmate-mcp — MCP 서버 검증·배포·등록

PinMate 회로 두뇌를 카카오 PlayMCP "AGENTIC PLAYER 10" 출품작으로 노출하는 MCP 서버 (server/)의 운영 루틴. 결정 근거=[[DECISION-LOG]] DEC-036, 상세 런북·신청 가이드=docs/ref/MCP-DEPLOY.md.

구성 (정본)

파일	역할
`server/tools.ts`	순수 도구 코어 — 회로 도메인(`src/features/circuit`) 순수 함수만 호출. 로직 수정은 여기.
`server/mcp.ts`	MCP 배선 — `McpServer`+Streamable HTTP(stateless)·도구 5종 등록·HTTP 서버.
`server/build.mjs`	esbuild 번들 → `dist/mcp.mjs`(SDK·zod·도메인 인라인, 외부 의존 0).
`server/smoke.mjs`	서버 spawn → 14항목 실호출 검증.
`server/__tests__/tools.test.ts`	도구 코어 단위테스트(결정론·동시성·매칭·에러).
`Dockerfile` / `.dockerignore`	linux/amd64 컨테이너(런타임=node:slim+번들만).

절차

1. 로컬 검증 (코드 바꿨으면 항상)

pnpm mcp:smoke     # 빌드→서버 spawn→14항목 실호출→결과표→종료
pnpm test          # tools.test 포함 전체
pnpm typecheck && pnpm lint

mcp:smoke가 검증하는 것: health·tools/list(5종+annotations 5종+"kakao"명 금지)·generate→diagnose/suggest/bom 체인·explain·에러(isError)·딥링크 Vercel 200·SLA(avg≤100ms·p99≤3s)·동시 100요청 격리(오염 0).
전부 ✅ 아니면 등록 금지. 딥링크 항목은 네트워크 없으면 SKIP.

2. 도구 수정 시 불변식

로직은 server/tools.ts만, 배선 server/mcp.ts는 가급적 그대로.
무상태 규약(절대): 핸들러에서 setActiveBoard/setActiveBreadboard 호출 금지. 보드/빵판은 code를 decodeCircuit→CircuitContext{breadboard,board}로 만들어 인자 주입(server/tools.ts ctxFor). 동시요청 오염 0의 근거(DEC-036 M0).
새 도구: read-only·비파괴·멱등·closed-world면 READONLY annotations 재사용. 도구명·서버명에 "kakao" 금지. 설명은 영문+「PinMate(핀메이트)」.
응답 ≤24k·동기·외부 I/O 금지(SLA).

3. 컨테이너 (M4, Docker Desktop 필요)

docker build --platform=linux/amd64 -t pinmate-mcp .
docker run --platform=linux/amd64 -p 8080:8080 pinmate-mcp
curl -s localhost:8080/health

카카오 클라우드는 linux/amd64만. Apple Silicon은 --platform 필수.

4. 대회 등록 (M5, 주인님 수동)

docs/ref/MCP-DEPLOY.md §M5 신청 가이드 따라: KC 배포→Endpoint 발급→PlayMCP 등록 ("정보 불러오기"→임시등록→AI채팅 테스트→심사요청)→전체공개→비즈폼 제출. 실질 마감 7/7.

규칙

검증(스모크·게이트)은 성역 — 통과 못 하면 "됐다" 금지.
코드/절차 바뀌면 [[docsync]]로 PROJECT-STATUS·WORK-BOARD·DEC-036 갱신.
haiku 조사 수치(일정·상금·SLA)는 등록 전 공식 페이지 재확인(research/21 표기 보존).

이 저장소의 다른 Skills

같은 저장소

pinmate-upload

Jason-hub-star/codegate

핀메이트(PinMate) 추천 스케치(.ino)를 개발 단계에서 실물 아두이노 보드에 arduino-cli 로 컴파일→업로드→검증한다. 보드 자동 감지(FQBN·포트)·스케치 폴더 규칙·avrdude 성공 판정까지 한 호흡. 트리거 — "보드에 올려줘", "아두이노 업로드", "이 코드 올려줘", "flash 해줘", "스케치 업로드", 추천 코드를 실물에서 돌려볼 때. ★ 이건 개발용 CLI 업로드(arduino-cli)지, 앱 내 WebSerial 펌웨어 브리지(DEC-045)가 아니다.

2026-06-240

docsync

Jason-hub-star/codegate

핀메이트(PinMate) 정본 문서 동기화. 코드·결정·계획이 바뀐 직후 호출하면 PROJECT-STATUS·WORK-BOARD·DECISION-LOG 등 정본을 일관되게 갱신하고 같은 사실이 여러 곳에 어긋나게 적힌 드리프트를 점검한다. "정본 1곳 원칙"을 강제한다. 트리거 — 변경 작업을 끝낸 뒤, "문서 갱신", "드리프트 점검", "상태 업데이트", "/docsync" 요청 시.

2026-06-240

free-part-leads

Jason-hub-star/codegate

핀메이트(PinMate) free 부품(서보 등 보드밖 GLB)의 리드선(피그테일)을 본체에 정확히 붙이고 보정한다. GLB 변환(seatModel 오프셋 포함)을 리드가 1:1로 복제해야 회전·이동·빵판 pose 에 무관하게 커넥터에 붙는다 — 이 계약을 어기면 "배치 땐 붙는데 회전하면 어긋남" 버그가 난다. 트리거 — 서보 같은 free 부품 리드가 본체에서 떨어지거나/엉뚱한 데 붙을 때, free 부품 추가·리드 보정·회전 정합, "선이 안 붙어", "회전하면 위치 변함", "리드 보정" 요청 시.

2026-06-240

model-calibrate

Jason-hub-star/codegate

핀메이트(PinMate) GLB 모델의 핀/단자 좌표를 재사용 가능하게 보정한다. GLB는 고정이라 코드로 핀 구멍 좌표를 알 수 없으므로 /calibrate 드래그드랍 도구로 한 번 찍어 calibration-data 에 저장하고 배선·net 에 쓴다. 트리거 — 새 GLB 부품(보드/ 센서/서보 등)을 빵판과 배선해야 할 때, "모델 보정", "핀 좌표 찍기", "새 모델 배선", "calibrate", "보정 도구" 요청 시.

2026-06-240

pinmate-add-part

Jason-hub-star/codegate

핀메이트 카탈로그에 새 부품(또는 보드/빵판 픽스처)을 누락 조인 없이 추가하는 스킬. "부품 추가", "부품 하나 넣어줘", "센서 추가", "카탈로그에 ~ 추가", "GLB 부품 등록", "팔레트에 부품 넣기" 같은 요청에 발동. DEC-030 "Add = one entry" 철학을 강제하되, 실제로는 parts(도메인)·render 전략(절차 빌더 또는 GLB)·assetCredits(라이선스)·CREDITS.md(정본)·CATEGORIES(분류)가 조인돼야 하므로 그 체크리스트와 무라이선스 금지 가드를 닫는다.

2026-06-240

pinmate-asset-gen

Jason-hub-star/codegate

핀메이트(PinMate)용 에디토리얼-안전 이미지 자산을 gpt-image-2로 생성한다. 브랜드 마크/favicon, OG 공유이미지, empty/success 스팟 일러스트, 빵판·PCB 텍스처 등 미리 정의된 템플릿 + 커스텀 프롬프트 지원. 모든 프롬프트에 에디토리얼 아카데믹 제약(모노크롬·직각·타이포, 네온·캐릭터·마스코트 금지)이 자동 부착된다. 트리거 — "핀메이트 자산 생성", "OG 이미지 만들어", "favicon 생성", "브랜드 마크", "스팟 일러스트", "빵판 텍스처 생성", "이미지 자산 만들어줘". 기본은 드라이런(과금 0), 실제 생성은 --go 필요(~$1/장).

2026-06-240

name

pinmate-mcp

description

pinmate-mcp — MCP 서버 검증·배포·등록

구성 (정본)

파일	역할
`server/tools.ts`	순수 도구 코어 — 회로 도메인(`src/features/circuit`) 순수 함수만 호출. 로직 수정은 여기.
`server/mcp.ts`	MCP 배선 — `McpServer`+Streamable HTTP(stateless)·도구 5종 등록·HTTP 서버.
`server/build.mjs`	esbuild 번들 → `dist/mcp.mjs`(SDK·zod·도메인 인라인, 외부 의존 0).
`server/smoke.mjs`	서버 spawn → 14항목 실호출 검증.
`server/__tests__/tools.test.ts`	도구 코어 단위테스트(결정론·동시성·매칭·에러).
`Dockerfile` / `.dockerignore`	linux/amd64 컨테이너(런타임=node:slim+번들만).

절차

1. 로컬 검증 (코드 바꿨으면 항상)

pnpm mcp:smoke     # 빌드→서버 spawn→14항목 실호출→결과표→종료
pnpm test          # tools.test 포함 전체
pnpm typecheck && pnpm lint

mcp:smoke가 검증하는 것: health·tools/list(5종+annotations 5종+"kakao"명 금지)·generate→diagnose/suggest/bom 체인·explain·에러(isError)·딥링크 Vercel 200·SLA(avg≤100ms·p99≤3s)·동시 100요청 격리(오염 0).
전부 ✅ 아니면 등록 금지. 딥링크 항목은 네트워크 없으면 SKIP.

2. 도구 수정 시 불변식

로직은 server/tools.ts만, 배선 server/mcp.ts는 가급적 그대로.
무상태 규약(절대): 핸들러에서 setActiveBoard/setActiveBreadboard 호출 금지. 보드/빵판은 code를 decodeCircuit→CircuitContext{breadboard,board}로 만들어 인자 주입(server/tools.ts ctxFor). 동시요청 오염 0의 근거(DEC-036 M0).
새 도구: read-only·비파괴·멱등·closed-world면 READONLY annotations 재사용. 도구명·서버명에 "kakao" 금지. 설명은 영문+「PinMate(핀메이트)」.
응답 ≤24k·동기·외부 I/O 금지(SLA).

3. 컨테이너 (M4, Docker Desktop 필요)

docker build --platform=linux/amd64 -t pinmate-mcp .
docker run --platform=linux/amd64 -p 8080:8080 pinmate-mcp
curl -s localhost:8080/health

카카오 클라우드는 linux/amd64만. Apple Silicon은 --platform 필수.

4. 대회 등록 (M5, 주인님 수동)

규칙

검증(스모크·게이트)은 성역 — 통과 못 하면 "됐다" 금지.
코드/절차 바뀌면 [[docsync]]로 PROJECT-STATUS·WORK-BOARD·DEC-036 갱신.
haiku 조사 수치(일정·상금·SLA)는 등록 전 공식 페이지 재확인(research/21 표기 보존).