심층 연구 MCP 서버

Deep Research는 웹 검색 및 고급 연구 기능을 제공하는 에이전트 기반 도구입니다. HuggingFace의 smolagents 활용하며 MCP 서버로 구현됩니다.

이 프로젝트는 HuggingFace의 open_deep_research 사례를 기반으로 합니다.

특징

• 웹 검색 및 정보 수집
• PDF 및 문서 분석
• 이미지 분석 및 설명
• YouTube 대본 검색
• 아카이브 사이트 검색

요구 사항

• Python 3.11 이상
• uv 패키지 관리자
• 다음 API 키:
  • OpenAI API 키
  • 허깅페이스 토큰
  • SerpAPI 키

설치

1. 저장소를 복제합니다.

지엑스피1

2. 가상 환경을 만들고 종속성을 설치합니다.

환경 변수

프로젝트의 루트 디렉토리에 .env 파일을 만들고 다음 환경 변수를 설정합니다.

Serper.dev 에 가입하면 SERPER_API_KEY를 얻을 수 있습니다.

용법

MCP 서버를 시작합니다.

이렇게 하면 deep_research 에이전트가 MCP 서버로 실행됩니다.

주요 구성 요소

• deep_research.py : MCP 서버의 진입점
• create_agent.py : 에이전트 생성 및 구성
• scripts/ : 다양한 도구 및 유틸리티
  • text_web_browser.py : 텍스트 기반 웹 브라우저
  • text_inspector_tool.py : 파일 검사 도구
  • visual_qa.py : 이미지 분석 도구
  • mdconvert.py : 다양한 파일 형식을 마크다운으로 변환합니다.

특허

이 프로젝트는 [라이선스 이름]에 따라 제공됩니다.

감사의 말

이 프로젝트는 HuggingFace의 smolagents 와 Microsoft의 autogen 프로젝트의 코드를 사용합니다.