Langflow와 MCP를 활용한 맞춤형 AI Git 커밋 메시지 생성기 구축

섹션별 상세

01

Langflow의 Agent 컴포넌트를 중심으로 Chat Input과 Chat Output을 연결하여 기본적인 대화형 구조를 설계한다. 이 구조는 사용자의 요청을 입력받아 에이전트가 처리한 후 결과를 반환하는 파이프라인의 뼈대가 된다. 에이전트는 연결된 도구들을 자율적으로 판단하여 사용할 수 있는 능력을 갖춘다.

02

Model Context Protocol(MCP)을 통해 에이전트에게 로컬 환경의 데이터 접근 권한을 부여한다. 공식 MCP 프로젝트의 Git 서버와 Filesystem 서버를 Langflow에 등록하여 에이전트가 소스 코드의 변경 이력과 파일 내용을 직접 읽을 수 있도록 설정한다. 이는 에이전트가 단순한 추측이 아닌 실제 프로젝트 컨텍스트에 기반하여 답변하도록 만든다.

Chat Input, Agent, Chat Output과 두 개의 MCP 서버 컴포넌트가 연결된 Langflow 워크플로우 다이어그램이다. — Diagram에이전트가 Filesystem과 Git MCP 서버로부터 도구를 공급받아 작동하는 전체 아키텍처를 시각화한다. 각 컴포넌트 간의 데이터 흐름과 도구 연결 방식을 명확히 보여주어 구현의 핵심 구조를 이해하는 데 필수적이다.

03

에이전트가 수행할 수 있는 작업의 범위를 도구 설정을 통해 정밀하게 제어한다. Filesystem MCP에서는 텍스트 파일 읽기 기능만 허용하고, Git MCP에서는 상태 확인 및 스테이징된 변경 사항 비교(diff) 기능만 활성화하여 보안성을 확보하고 에이전트의 오작동을 방지한다. 필요한 도구만 선택적으로 노출함으로써 모델의 추론 효율성을 높인다.

json

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git"]
    }
  }
}

Langflow에서 Git MCP 서버를 연동하기 위한 JSON 설정 예시

MCP 컴포넌트 내에서 활성화할 도구 목록과 설명을 선택하는 설정 화면이다. — Screenshot에이전트에게 허용할 특정 Git 및 파일 시스템 액션을 세밀하게 제어하는 방법을 보여준다. GIT_STATUS, GIT_DIFF_STAGED 등 필요한 도구만 선택하여 에이전트의 범위를 제한하는 실무적인 설정 단계를 설명한다.

04

Conventional Commits 스타일을 준수하도록 에이전트의 페르소나와 지침을 구성한다. 시니어 소프트웨어 개발자 역할을 부여하고, 스테이징된 파일의 주요 변경 사항을 요약하여 간결한 제목과 상세한 본문을 작성하도록 프롬프트를 설계한다. 백틱이나 불필요한 부연 설명 없이 순수하게 커밋 메시지만 반환하도록 제약 조건을 설정한다.

05

완성된 Langflow 워크플로우를 Node.js 기반의 CLI 도구로 변환하여 터미널 환경에 통합한다. Langflow SDK를 사용하여 현재 작업 디렉토리 경로를 에이전트에 전달하고 생성된 메시지를 출력하는 스크립트를 작성한다. 이를 통해 사용자는 터미널에서 명령어 한 줄로 AI 기반 커밋 메시지를 생성하고 즉시 커밋 명령과 연결하여 자동화할 수 있다.

용어 해설

모델 컨텍스트 프로토콜(Model Context Protocol): — AI 모델이 로컬 파일 시스템, 데이터베이스, API 등 외부 데이터 소스 및 도구와 안전하고 표준화된 방식으로 상호작용할 수 있도록 Anthropic에서 제안한 개방형 표준이다. 이를 통해 에이전트는 실시간 데이터에 접근하거나 로컬 환경에서 직접 작업을 수행할 수 있는 능력을 갖춘다.
랭플로우(Langflow): — 드래그 앤 드롭 방식의 시각적 인터페이스를 통해 복잡한 LLM 파이프라인과 AI 에이전트를 설계, 구축, 테스트할 수 있는 로우코드 프레임워크이다. 파이썬 기반으로 작동하며 다양한 컴포넌트를 연결하여 워크플로우를 빠르게 프로토타이핑하고 API 형태로 배포할 수 있도록 지원한다.
컨벤셔널 커밋(Conventional Commits): — 커밋 메시지에 명확한 구조를 부여하여 인간과 기계 모두가 이해하기 쉽게 만드는 규약이다. feat, fix, docs 등의 접두어를 사용하여 변경 사항의 성격을 명시하며, 이를 통해 자동화된 버전 관리 및 변경 이력(Changelog) 생성을 용이하게 한다.
깃 디프(Git Diff): — Git 버전 관리 시스템에서 두 데이터 소스 간의 차이점을 추출하는 명령어 또는 그 결과물이다. 주로 작업 디렉토리와 스테이징 영역 간의 코드 변경 사항을 라인 단위로 비교하여 에이전트가 어떤 부분이 수정되었는지 파악하는 핵심 컨텍스트로 활용된다.

기술

Langflow
Model Context Protocol
Git MCP Server
Node.js
OpenAI API

활용 사례

자동 Git 커밋 메시지 생성
코드 변경 사항 요약 에이전트
CLI 기반 AI 개발 보조 도구

언급된 리소스

GitHubgit-ai-message GitHub Repository

API DocsLangflow Documentation

문서Model Context Protocol Official Project