supernote-mcp의 개요
GitHub 사용자 ridget의 supernote-mcp는 같은 Wi-Fi 네트워크에 있는 전자잉크 태블릿 Ratta Supernote에 MCP 클라이언트를 연결합니다. 글을 쓰는 동안 실시간 화면을 가져오고, 파일 목록을 보여 주고, 노트의 필기 인식 결과를 텍스트로 또는 페이지를 이미지로 돌려주며, 태블릿과 파일을 주고받습니다. 태블릿에 이미 있는 두 기능을 씁니다. 포트 8080의 Screen Mirroring과 포트 8089의 파일 서버 Browse & Access입니다.
MIT 라이선스의 TypeScript로 작성됐고 npm 과 다섯 개 플랫폼용 독립 실행 바이너리로 배포되며, GitHub 스타는 약 2개입니다. 2026년 9월 22일에 나온 버전 0.2.3에서 다운로드 도구가 추가됐습니다. Ratta와는 관계가 없습니다.
supernote-mcp 설치 방법
npx -y supernote-mcpsupernote-mcp, 쓸 만한 가치가 있습니까?
supernote-mcp가 하는 일은 여섯 가지이며 모두 군더더기 없이 처리합니다. supernote_snapshot은 현재 화면을 PNG로 돌려주고, 목록, 읽기, 렌더링 도구는 저장된 노트를 훑으며, 업로드와 다운로드는 파일을 옮깁니다. 노트를 읽으면 태블릿 자체의 필기 인식 결과가 텍스트로 돌아오므로 이미지보다 모델 비용이 훨씬 적게 듭니다. 렌더링은 호출당 20페이지로 제한됩니다. 모든 도구는 10초 뒤 시간 초과되며 원인으로 보이는 것을 알려 주는 메시지를 내고, 호출되기 전에는 태블릿에 손대지 않습니다.
기대는 두 인터페이스 모두 리버스 엔지니어링으로 알아낸 것이며, README도 그렇게 밝힙니다. 화면 미러와 Browse & Access는 프로그램용으로 문서화되지 않았고, 펌웨어 업데이트로 바뀌거나 망가질 수 있습니다. Ratta 지원 페이지는 Browse & Access를 같은 Wi-Fi에서 브라우저로 여는 파일 서버로 설명하며, 그 페이지와 README 어디에도 비밀번호나 PIN 언급이 없습니다. 어느 쪽에도 태블릿이 접속 상대를 제한한다는 내용이 없으니, 스위치가 켜져 있는 동안에는 화면이나 파일이 그 네트워크의 누구에게나 열려 있다고 보아야 합니다.
주의할 점: 에이전트는 양방향 파일 접근 권한을 얻습니다. supernote_upload_file은 서버 프 로세스가 읽을 수 있는 로컬 파일이면 무엇이든 보내고, supernote_download_file은 로컬 경로에 씁니다. 기본값은 $TMPDIR입니다. 설정한 주소가 실패하면 서버는 태블릿을 찾으려고 서브넷 전체를 포트 8080으로 훑습니다. 사무실 네트워크에서는 이 검색 자체가 경보를 울릴 수 있으며, SUPERNOTE_DISCOVER=0으로 끌 수 있습니다. 컴퓨터의 VPN이나 프록시는 연결을 끊습니다.
결론: 종이처럼 계획을 세우고 내보내기 없이 스케치를 채팅으로 가져오고 싶은 Supernote 사용자에게 가장 짧은 길이며, 설정은 스위치 두 개와 IP 주소 하나면 됩니다. 태블릿 기능은 해당 세션 동안에만 켜고, 큰 펌웨어 업데이트 뒤에는 단 한 명의 개발자가 따라잡을 때까지 공백이 생길 수 있다고 생각하십시오.
제 역할을 하는 곳
회의 중 Supernote Manta에 화면 흐름을 그리는 제품 관리자
오늘 오후에 그린 스케치를 문서화된 사양으로 바꾸고 싶다
Screen Mirroring을 켜고 에이전트에게 화면 스냅샷을 찍게 한 뒤 그 이미지로 사양 초안을 쓰게 합니다. 무료이며, 스냅샷 한 장이 모델 컨텍스트의 이미지 한 장입니다.
Nomad에 한 학기 강의 노트를 쌓아 둔 대학원생
시험 전에 한 주제에 관한 내 노트를 요약하고 싶다
Browse & Access를 열고 에 이전트가 /Note 목록을 본 뒤 관련 노트를 supernote_read_note로 텍스트로 읽게 합니다. 인식된 텍스트가 없는 노트는 호출당 최대 20페이지의 렌더링 페이지로 대신합니다.
태블릿에서 PDF에 주석을 다는 변호사
초안을 내 Supernote로 보내고 주석 단 사본을 다시 가져오고 싶다
supernote_upload_file로 PDF를 올리고 기기에서 주석을 단 다음 supernote_download_file로 가져옵니다. 공유 사무실 Wi-Fi에서는 쓰지 않을 때 Browse & Access를 꺼 둡니다.
도입 전 확인할 점
- 설정
- 태블릿에서 Screen Mirroring이나 Browse & Access를 켜고 IP 주소를 적어 둔 뒤, SUPERNOTE_IP를 설정해 claude mcp add로 npx -y supernote-mcp를 등록합니다. Node.js 18+, Bun 또는 독립 실행 바이너리가 필요하며, DHCP 예약으로 IP를 고정할 수 있습니다.
- 연동
- Screen Mirroring을 지원하는 Supernote 기기(Manta, Nomad, A5X, A6X 계열). 프레임 캡처와 .note 해석에는 supernote-typescript 라이브러리를 씁니다. stdio를 지원하는 모든 MCP 클라이언트.
- 데이터와 개인정보
- stdio로 로컬에서 동작합니다. 화면 이미지, 노트 텍스트, 파 일 내용은 모델 제공업체로 전달됩니다. 태블릿의 미러(포트 8080)와 파일 서버(포트 8089)는 켜져 있는 동안 로컬 네트워크에서 접근할 수 있습니다. 업로드는 서버가 접근할 수 있는 로컬 파일이면 무엇이든 읽습니다.
- 대규모 사용 시 비용
- MIT로 무료입니다. 비용은 태블릿뿐입니다.
- 제한
- 같은 Wi-Fi 네트워크여야 하며 VPN이나 프록시가 없어야 합니다. 비공개 인터페이스는 펌웨어 업데이트로 깨질 수 있습니다. 렌더링은 20페이지까지이며 호출은 10초 뒤 시간 초과됩니다.
좋은 점
- 필기 인식 결과를 이미지뿐 아니라 텍스트로 읽음
- 10초 시간 제한과 명확한 오류 메시지
- npm, Bun, 독립 실행 바이너리로 설치 가능
- 도구를 호출할 때만 태블릿에 접근
아쉬운 점
- 리버스 엔지니어링한 비공개 인터페이스에 의존
- 태블릿의 미러와 파일 서버는 비밀번호를 요구하지 않음
- 대체 검색이 서브넷 전체를 훑음
- 개발자 한 명, 스타 약 2개
추천 대상
계획을 세우거나 회의할 때 손으로 쓰고 그 페이지를 에이전트가 읽게 하고 싶은 Supernote Manta, Nomad, A5X, A6X 사용자.
supernote-mcp: 자주 묻는 질문
- supernote-mcp, 쓸 만한 가치가 있습니까?
- Supernote의 손글씨를 에이전트와의 대화에서 쓸모 있게 만드는 깔끔하고 범위가 좁은 연결 도구이지만, 다음 펌웨어 업데이트로 바뀔 수 있는 문서화되지 않은 인터페이스에 기대고 있습니다. 평점은 5점 만점에 3.6점입니다.
- supernote-mcp의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다. Screen Mirroring 또는 Browse & Access를 지원하는 Supernote가 필요합니다.
- supernote-mcp의 단점은 무엇입니까?
- 리버스 엔지니어링한 비공개 인터페이스에 의존; 태블릿의 미러와 파일 서버는 비밀번호를 요구하지 않음; 대체 검색이 서브넷 전체를 훑음; 개발자 한 명, 스타 약 2개.
- supernote-mcp에 적합한 사람은 누구입니까?
- 계획을 세우거나 회의할 때 손으로 쓰고 그 페이지를 에이전트가 읽게 하고 싶은 Supernote Manta, Nomad, A5X, A6X 사용자.
- 팀이나 프로덕션 환경에서 supernote-mcp의 비용은 얼마입니까?
- MIT로 무료입니다. 비용은 태블릿뿐입니다.
- supernote-mcp에 회사 데이터를 맡겨도 안전합니까?
- stdio로 로컬에서 동작합니다. 화면 이미지, 노트 텍스트, 파일 내용은 모델 제공업체로 전달됩니다. 태블릿의 미러(포트 8080)와 파일 서버(포트 8089)는 켜져 있는 동안 로컬 네트워크에서 접근할 수 있습니다. 업로드는 서버가 접근할 수 있는 로컬 파일이면 무엇이든 읽습니다.
답변 확인일: 2026년 11월 14일.