mcp-use

mcp-use는 서버, 클라이언트, 에이전트의 전 과정을 아우르며 TypeScript MCP와 Python을 모두 지원한다. 동작하는 구성을 만들기 위해 여러 라이브러리를 섞을 필요가 없고, 두 언어는 같은 개념과 이름을 공유한다. 팀은 이를 풀스택 프레임워크라고 부르는데, 이번에는 그 이름이 어울린다. 하나의 프로젝트가 만드는 쪽과 그것을 호출하는 쪽을 동시에 건드리기 때문이다.

npx create-mcp-use-app my-app를 실행하면 서버, React UI 계층, 개발 서버가 이미 연결된 동작하는 프로젝트가 생성된다. 첫 도구 호출 전에 보통 따라오는 설정 작업을 통째로 건너뛰자는 취지다. Python에서는 pip install mcp-use 한 번이면 서버 프레임워크를 얻는다.

프레임워크에는 서버를 실제 클라이언트에 맞춰 돌려보는 웹 Inspector가 들어 있다. 도구 호출을 쏘고, 원시 JSON-RPC를 읽고, GPT, Claude, Gemini 같은 모델을 바꿔가며 동작을 비교한다. 로컬에 아무것도 세팅하지 않고 브라우저에서 디버깅할 수 있어, 특정 모델에서만 문제가 나타날 때 특히 유용하다.

서버를 넘어 mcp-use는 MCP 앱도 만든다. ChatGPT와 Claude 안에서 텍스트가 아니라 진짜 인터페이스로 그려지는 React 위젯이다. 프레임워크가 이런 UI 리소스를 일급으로 지원하므로, 대화형 앱을 한 번 만들면 여러 환경에서 돈다. mcp-use를 저수준 MCP 라이브러리와 갈라놓는 기능이 바로 이것이다.

클라이언트 쪽은 어떤 LLM이든 어떤 MCP 서버에 연결하고, 에이전트가 필요 없을 때 도구를 직접 호출하게 해준다. 에이전트 쪽은 단계를 넘나드는 추론, 도구 사용, 웹 탐색, 파일 처리를 더한다. 둘 다 같은 패키지에 속하므로, 스크립트형 클라이언트에서 완전한 에이전트로 옮겨가도 두 번째 프레임워크를 배울 필요가 없다.

연동된 호스팅 플랫폼은 저장소를 돌아가는 서버로 바꾼다. GitHub을 한 번 연결하면 푸시마다 자동 배포되고, 브랜치마다 미리보기 URL이 생기며, 사용자 도메인과 SSL도 함께 처리된다. 대시보드에서 요청, 빌드, 테스트, 런타임 로그를 추적하니 운영이 한곳에 모인다.

서버 프레임워크는 공식 MCP SDK를 대체하지 않고 확장하므로, 기존 서버가 깨지지 않고 옮겨가며 규격도 계속 준수한다. 문서 엔드포인트, 구조화 로깅, 발견용 openmcp.json 메타데이터 파일을 더한다. 이 조합 덕에 더 넓은 MCP 생태계와 호환을 유지하면서 운영에 필요한 부품을 채운다.