res-mcp는 Rails Event Store를 MCP 서버로 노출해 AI 어시스턴트가 이벤트 스트림, 이벤트 타입, aggregate 흐름을 질의할 수 있게 하는 도구다. 개발자가 SQL이나 내부 콘솔 명령을 직접 입력하기보다, “이 주문이 왜 취소됐나” 같은 질문으로 이벤트 흐름을 추적하게 만든다.
어떤 문제를 푸는가
이벤트 소싱(event sourcing) 시스템은 상태보다 이력으로 진실을 설명한다. 그러나 이벤트가 많아지면 어떤 스트림을 봐야 하는지, 이벤트 간 인과관계가 무엇인지 사람이 매번 찾아야 한다. res-mcp는 이 탐색 과정을 AI 어시스턴트의 도구 호출로 바꾼다.
사용 방식
Rails 앱에 res-mcp를 연결하면 AI 클라이언트는 이벤트 타입 목록, 특정 stream, 관련 이벤트를 조회할 수 있다. 중요한 점은 “명령을 실행”하게 하는 것이 아니라 “질문을 통해 관찰”하게 하는 것이다. 프로덕션 변경 권한 없이 읽기 중심 탐색 도구로 쓰는 편이 안전하다.
어디에 적합한가
- Rails Event Store를 쓰는 도메인 이벤트 기반 시스템
- 장애 조사에서 특정 aggregate의 상태 변화 이유를 추적해야 할 때
- 신규 개발자가 이벤트 모델과 도메인 흐름을 빠르게 이해해야 할 때
관련 문서
- mcp — 모델 컨텍스트 프로토콜
- ruby-llm — Ruby와 Rails에서 여러 AI 제공자를 쓰는 프레임워크
- agentic-resource-discovery — 에이전트 리소스 발견 명세
참고 자료
- Let Your AI Assistant Explore the Event Store with res-mcp — Arkency Blog (2026-06-25)