DeepMCPAgent: LangChain/LangGraph와 MCP를 활용한 도구 자동 연결의 혁신

AI 기반 애플리케이션을 개발할 때 가장 번거로운 과정 중 하나는 다양한 외부 API와 도구를 일일이 연결하는 일입니다. 데이터베이스 쿼리, 검색 엔진 호출, 외부 API 연동 등 모든 기능을 매번 하드코딩해야 한다면 확장성과 유지보수에서 한계를 느끼게 됩니다. 이러한 문제를 해결하기 위해 등장한 것이 바로 DeepMCPAgent입니다.

DeepMCPAgent는 LangChain과 LangGraph의 장점을 그대로 가져오면서, **Model Context Protocol(MCP)**을 기반으로 도구 탐색과 연결을 자동화합니다. 결과적으로 개발자는 복잡한 도구 정의나 수동 연결 과정을 생략하고, 곧바로 프로덕션 환경에서 쓸 수 있는 에이전트를 구축할 수 있습니다.

반응형

---

DeepMCPAgent란 무엇인가?

DeepMCPAgent는 Python 패키지로, LangChain 또는 LangGraph 기반 에이전트를 손쉽게 만들 수 있도록 설계되었습니다. 가장 큰 특징은 도구를 직접 정의하지 않고 MCP 서버에서 자동으로 불러온다는 점입니다. HTTP 또는 SSE 기반의 MCP 서버와 연결해 필요한 기능을 실시간으로 탐색하고, 바로 사용할 수 있습니다.

또한 특정 모델 제공자에 종속되지 않고, OpenAI, Anthropic, Ollama, Groq 또는 로컬 모델 등 다양한 모델을 자유롭게 선택할 수 있습니다. 즉, **모델 독립적 구조(model-agnostic)**를 제공한다는 점이 중요한 장점입니다.

---

주요 기능

DeepMCPAgent가 제공하는 핵심 기능은 다음과 같습니다.

1. 동적 도구 탐색

• MCP 서버와 연결해 list_tools 요청을 보내고
• 반환된 JSON-Schema를 Pydantic 모델로 변환한 뒤
• LangChain BaseTool로 구성하여 곧바로 사용

이 과정을 통해 입력값 검증이 자동으로 이루어지고, 오류 가능성이 크게 줄어듭니다.

2. 모델 독립성

• OpenAI GPT-4.1, Anthropic Claude, Ollama Llama3 등 원하는 모델을 문자열(provider-id)이나 인스턴스로 지정 가능
• LangChain의 init_chat_model()을 통해 API 키를 불러와 바로 실행 가능

3. CLI 및 Python API 지원

개발자가 코드를 직접 작성하지 않아도, CLI 명령어만으로 MCP 서버 연결 및 도구 확인이 가능합니다.

예시 명령어:

deepmcpagent list-tools \
  --http name=math url=http://127.0.0.1:8000/mcp transport=http \
  --model-id "openai:gpt-4.1"

---

아키텍처 개요

DeepMCPAgent는 크게 세 가지 계층으로 구성됩니다.

1. 에이전트 계층: LangChain 모델과 LangGraph 기반의 에이전트 루프를 실행
2. 도구 로딩 계층: MCP 서버로부터 도구 정보를 받아 BaseTool로 변환
3. FastMCP 클라이언트 계층: HTTP/SSE 통신을 통해 여러 MCP 서버와 동시에 연결

이 구조 덕분에 개발자는 새로운 MCP 서버를 붙이는 것만으로 다양한 API를 바로 활용할 수 있습니다.

---

기존 방식과의 차별성

일반적인 LangChain 프로젝트에서는 도구를 직접 정의하고 연결해야 합니다. 예를 들어 OpenAI API를 붙이거나 데이터베이스 쿼리 도구를 만들려면 별도 코드 작성이 필요합니다.

LangGraph 기반 ReAct 에이전트 역시 구조화된 상호작용은 제공하지만, 여전히 수동 정의가 필요합니다.

반면 DeepMCPAgent는 MCP 서버와 FastMCP 클라이언트를 활용해 이 과정을 자동화합니다. 따라서 유지보수와 확장성이 훨씬 뛰어나며, 복잡한 시스템에서도 효율적으로 적용할 수 있습니다.

---

보안과 안정성

DeepMCPAgent는 보안 측면에서도 신뢰할 수 있는 구조를 갖추고 있습니다.

• API 키나 인증 토큰을 직접 관리하지 않음
• HTTP 헤더 설정을 통해 MCP 서버에 안전하게 전달
• mypy, ruff, pytest 등 정적 분석 및 테스트 환경 지원
• GitHub Actions 기반 CI/CD로 안정성 확보

---

728x90

DeepMCPAgent는 LangChain의 유연함, LangGraph의 구조적 설계, MCP의 자동화된 도구 탐색을 결합한 강력한 프레임워크입니다.

이를 통해 개발자는 반복적인 도구 연결 과정을 자동화하고, 유지보수 부담을 줄이며, 새로운 기능을 훨씬 빠르게 확장할 수 있습니다.

앞으로 AI 기반 애플리케이션 개발에서 도구 연결은 더 이상 발목을 잡는 요소가 되지 않을 것입니다. DeepMCPAgent는 그 출발점에 있습니다.

https://github.com/cryxnet/DeepMCPAgent

GitHub - cryxnet/DeepMCPAgent: Model-agnostic plug-n-play LangChain/LangGraph agents powered entirely by MCP tools over HTTP/SSE