mcp-use
무엇인가
MCP 서버와 MCP 앱을 TypeScript로 작성할 때 지켜야 할 구조를 규율하는 플러그인이다. 도구 정의, 입출력 스키마, 뷰 연결, 개발·검증·배포 명령을 하나의 파이프라인으로 묶어 에이전트가 매 단계에서 같은 형식을 따르게 한다. 대상 문제 영역은 MCP 서버 스캐폴딩과 도구-UI 계약, 그리고 로컬 검증 루프다.
어떻게 동작하나
동작 방식은 코드 계약으로 고정된다. `MCPServer` 인스턴스를 만들고 `server.tool()`에 `inputSchema`·`outputSchema`를 Zod 객체로 넘기며, `view: { name: "weather-card" }`로 `views/weather-card/view.tsx`의 React 컴포넌트를 도구에 직접 바인딩한다. 뷰는 `mcp-use/react`의 `useToolContext`·`useCallTool` 훅으로 도구 입력·출력과 재호출을 다룬다. 개발 모드에서 MCP 엔드포인트는 `http://localhost:3000/mcp`, Inspector는 `http://localhost:3000/mcp/inspector`에 뜨고, CLI는 `mcp-use dev`, `mcp-use client connect`, `mcp-use screenshot`으로 같은 서버를 헤드리스로 조회·호출·캡처한다.
무엇과 다른가
공식 TypeScript SDK v2를 기반으로 삼되 그 위에 뷰 바인딩, 도구에서 UI까지 이어지는 타입 계약, stateless 런타임, Inspector, 스크린샷 검증, 에이전트 우선 CLI, 배포를 얹는다는 점이 다르다. 프롬프트를 직접 써서 규칙을 흉내 내거나 정적 규칙 파일만 두는 방식과 달리, 스키마와 뷰가 실제 실행 코드로 강제되고 검증 명령이 함께 제공된다.
어떻게 쓰나
설치는 `npx -y create-mcp-use-app@latest`로 스캐폴드를 생성한 뒤 프로젝트에서 `npm run dev`를 실행하는 순서다. 에이전트에 작업을 맡길 때는 `Build an MCP server: https://mcp-use.com/prompt.md` 프롬프트를 전달하고, v1 프로젝트는 마이그레이션 가이드 URL을 담은 프롬프트로 v2로 옮긴다. 배포는 `npm run deploy` 또는 자체 호스팅 가이드를 따른다.
전제와 한계
전제는 Node.js와 npm, TypeScript, React 뷰 파이프라인이다. Claude Code에 플러그인으로 붙지만 산출물은 MCP 서버이므로 ChatGPT 플러그인·Claude 커넥터로 배포해 쓰는 것이 전제이며, 로컬 서버를 외부에서 시험하려면 Inspector UI의 터널 또는 `mcp-use dev --tunnel`이 필요하다. README에 명시되지 않은 언어·런타임 지원이나 비 TypeScript 경로는 다루지 않는다.
관련 논문 1
유사 도구
- inspectorMCP 서버를 웹·CLI·TUI 세 가지 방식으로 검사하는 TypeScript 개발 도구다. 전역 mcp-inspector 바이너리 하나로 실행한다.
- AionUiClaude Code 등 CLI 에이전트를 하나의 Cowork 화면에 묶어 다중 에이전트 팀 편성·MCP 통합 관리·PPT/Word/Excel 문서 생성 절차를 주입하는 스킬 묶음이다.
- open-design에이전트가 DESIGN.md 디자인 시스템과 스킬·플러그인 규칙을 읽어 프로토타입·덱·이미지·영상 산출물을 실제 파일로 생성하도록 절차를 주입하는 Claude Code 플러그인이다.
- n8n-as-coden8n 워크플로를 TypeScript로 생성·검증·동기화하도록 노드 스키마와 템플릿, GitOps 절차를 에이전트에 주입하는 Claude Code 스킬 묶음이다.
- openInvestAI 에이전트에 다중 에이전트 투자위원회 절차를 주입해, 정보 격리·반박 라운드·감사 가능한 판정 기록을 강제하는 Claude Code 플러그인이다.
- supermlML 파이프라인 스킬로 프레임워크 문서 기반 계획, 실행 전 설정 검증, OOM·NaN 원인별 디버깅, 세션 간 실험 기억을 에이전트에 주입하는 Claude Code 플러그인이다.