hypothesi/mcp-server-tauri

MCP Server Tauri – Tauri 앱을 위한 AI 강화 개발

무엇인가요 – AI 어시스턴트(Claude, Cursor, Windsurf 등)와 통신하는 Model Context Protocol(MCP) 서버로, 실행 중인 Tauri v2 애플리케이션에 대한 실시간 통찰을 제공합니다. 스크린샷, DOM 스냅샷, 콘솔 로그, Tauri IPC 트래픽을 스트리밍하고, UI 자동화, IPC 검사 또는 전송, 모바일 시뮬레이터 목록 조회 등에 사용할 수 있는 21개의 명령어를 노출합니다.

왜 중요한가요 – 현대의 AI 코딩 어시스턴트는 GUI 앱에 대해 추론하기 위해 구체적이고 최신의 컨텍스트가 필요합니다. Tauri 웹뷰와 네이티브 측면에서 시각적 및 구조적 데이터를 공급함으로써 어시스턴트는 다음을 가능하게 합니다:

UI 버그를 자동으로 진단
앱의 IPC 계층과 상호작용하는 코드 생성 또는 수정
Selenium과 같은 외부 도구 없이 UI 조작(클릭, 입력, 스크롤)
단일 브리지로 데스크톱, Android, iOS에서 작업 가능

주요 기능

카테고리	도구 (총 21개)
UI 자동화	스크린샷, 요소 찾기, 클릭/스크롤/입력, 시각적 선택기, DOM 스냅샷, CSS 스타일 쿼리, JS 실행, 윈도우 관리
IPC 모니터링	Tauri IPC 호출 실시간 캡처, 상태 검사, 사용자 정의 이벤트 발행
모바일 개발	iOS 시뮬레이터 및 Android 에뮬레이터 목록 조회
로그	콘솔, Android logcat, iOS 로그, 시스템 로그 스트리밍
설정	`/setup` 명령어로 Rust 브리지 플러그인을 Tauri 프로젝트에 추가

사용 방법

사전 요구 사항 설치 – Node 20+, Rust/Cargo, Tauri CLI, (옵션) Xcode/Android SDK.
aix CLI로 AI 어시스턴트에 MCP 추가:
```
npx -y @a1st/aix add mcp tauri --command 'npx @hypothesi/tauri-mcp-server' --user
```
어시스턴트는 서버 시작 및 슬래시 명령어 호출 방법을 학습합니다.
Tauri 앱 구성 – 어시스턴트에게 /setup를 실행하도록 요청하거나, 수동 가이드를 따릅니다.
서버 실행 – npx @hypothesi/tauri-mcp-server로 stdio 기반 MCP 서버를 시작합니다.
상호작용 – 어시스턴트에서 /select(시각적 요소 선택기) 또는 /fix-webview-errors와 같은 명령어를 입력합니다. CLI도 직접 호출 가능: 예) tauri-mcp webview-screenshot --file out.png.

아키텍처 개요

AI 어시스턴트  ←→  MCP 서버 (Node.js)  ←WebSocket→  Tauri 앱
   │                │                     │
   │                ├─ Manager (CLI/설정)   └─ MCP 브리지 플러그인 (Rust)
   │                ├─ Driver (UI 자동화)   └─ WebView (DOM/UI)
   │                └─ Monitor (로그 및 IPC)

브리지 플러그인은 작은 Rust 라이브러리를 Tauri 바이너리에 삽입하여 서버가 어시스턴트로 전달하는 IPC 명령어와 상태를 노출합니다. 외부 브라우저나 드라이버는 필요 없습니다.

빠른 시작 방법

# 복제 및 설치
git clone https://github.com/hypothesi/mcp-server-tauri.git
cd mcp-server-tauri
npm install

# 패키지 빌드
npm run build

# 서버 시작 (AI 클라이언트와 stdio 파이프로 통신)
npx @hypothesi/tauri-mcp-server

실습용 데모로 포함된 test-app Tauri 프로젝트도 실행할 수 있습니다.

누가 관심을 가져야 할까요

Tauri로 데스크톱 앱을 개발하고 AI 기반 디버깅이나 코드 생성을 원하는 개발자.
Claude, Cursor 등과 같은 어시스턴트를 사용하며 UI 상태를 어시스턴트가 볼 수 있도록 하고 싶은 팀.
Selenium/Playwright 없이 데스크톱 및 모바일 Tauri 타겟에서 UI 상호작용을 스크립트로 처리하고 싶은 사람.

라이선스 – MIT (LICENSE 참조).

본 프로젝트는 hypothesi 조직에서 유지보수되며, Tauri Programme와 공식적으로 관련이 없습니다.