LangGraph ReAct 에이전트에 외부 도구를 재시작 없이 연결하는 MCP 툴 레지스트리 구축
요약
본 글은 LangGraph와 MCP(Message Channel Protocol)를 활용하여 외부 도구를 재시작 없이 연결하는 에이전트 워크스페이스 구축 과정을 다룹니다. GitHub, Gmail, 금융 API 등 다양한 서비스를 즉각적으로 연동할 수 있으며, 민감한 작업(예: 이메일 발송)에는 사용자 승인 단계를 거치도록 설계되었습니다.
핵심 포인트
- LangGraph와 MCP를 이용해 외부 도구를 재시작 없이 연결하는 에이전트 워크스페이스 구축
- GitHub, Gmail, 금융 API 등 12개 이상의 다양한 도구 연동 및 실시간 인식 구현
- 민감한 작업(답장 발송)은 사용자 UI 승인 단계를 거쳐 보안 강화
평소에 하던 커버레터 프로젝트에서 잠시 벗어나, 실제로 무언가를 할 수 있는 (단순히 대화만 하는 것이 아닌) 에이전트 워크스페이스를 이번에는 만들어 보았습니다. 다만 돌이킬 수 없는 일이 발생하기 전에 확실하게 멈출 수 있는 장치가 있다는 점이 중요합니다. 제가 가장 자랑스러워하는 부분은, MCP(Message Channel Protocol)를 통해 SSE(Server-Sent Events)로 사용하기 때문에, GitHub, Gmail, 금융 API 등 완전히 새로운 도구를 연결할 수 있고, 에이전트가 이를 즉시 인식한다는 것입니다. 재시작이나 배포가 필요 없습니다. 현재는 GitHub 분석, Gmail 읽기/초안 작성, 실시간 웹 검색, 주식 데이터 및 몇 가지 유틸리티 도구에 걸쳐 12개 이상의 도구와 연결되어 있습니다. 제가 정말로 긴장했던 부분은 에이전트가 실제 받은 편지함(inbox)을 건드리는 것이었습니다. 그래서 SMTP를 통해 어떤 내용이 발송되기 전에는 UI에 승인 단계가 마련되어 있습니다. 에이전트는 답장을 초안 작성할 수는 있지만, 스스로 보내지는 못합니다. 제가 확인 버튼을 눌러야 합니다. 백엔드는 FastAPI와 LangGraph로 구성되었고, 프론트엔드는 Next.js이며, 512MB RAM 제한 내에서 Render에 배포하는 과정 자체가 새벽 2시에 별도의 골칫거리였습니다. 그리고 오늘 아침에는 공용 MCP 신뢰 인덱스(trust index)에 검증된 목록으로 올라와 있었습니다. 제가 제출한 것이 아니라, 그들의 크롤러가 발견한 것입니다. 작은 고백을 하자면: 이 게시물의 문구를 다듬는 데 AI를 사용했습니다. 하지만 아키텍처, 코드, 그리고 디버깅은 저의 몫이었습니다. 링크와 레포지토리는 댓글에 남겨두겠습니다. (게시물 텍스트는 AI 도움을 받아 작성했지만 — 아키텍처, 코드, 디자인 결정은 모두 제 것입니다.)
AI 자동 생성 콘텐츠
본 콘텐츠는 r/SelfHosted (AI filter)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기