Role1776/mcp-retrieval

어떤 프로젝트인가요?

핵심 기능

• 01웹 검색, 이미지 검색, 페이지 스크래핑을 위한 읽기 전용 도구 세 가지를 제공합니다.
• 02검색과 페이지 콘텐츠를 검색 엔진 API 키 없이 사용할 수 있습니다.
• 03readability 파서로 페이지 콘텐츠를 추출해 Markdown으로 반환합니다.
• 04브라우저 TLS 핑거프린트 가장과 선택적 로테이션 프록시를 지원합니다.
• 05stdio와 스트리밍 가능한 HTTP 전송 방식을 지원합니다.
• 06항목별 상태를 보고하므로 일부 요청이 실패해도 성공한 결과를 반환합니다.

활용 사례

• 검색 API 비용 없이 로컬 LLM 어시스턴트에 실시간 웹 검색 결과를 제공할 수 있습니다.
• 웹페이지의 기사 내용을 깔끔한 Markdown으로 변환해 모델에 전달할 수 있습니다.
• 코딩 중 IDE 에이전트가 문서나 최신 정보를 검색하도록 할 수 있습니다.
• 팀에서 HTTP를 통해 공동으로 사용할 검색 서버를 운영할 수 있습니다.

빠른 시작

1. 1

   소스에서 바이너리를 빌드합니다(Go 1.25.5 이상 필요).

   make build
2. 2

   기본 stdio 전송 방식으로 서버를 실행합니다.

   ./bin/mcp-retrieval

사용 전 알아둘 점

• !web_scrape는 HTML만 처리하므로 raw.githubusercontent.com 같은 일반 텍스트 및 파일 URL에서는 아무것도 반환하지 않습니다.
• !이미지 검색 결과의 관련성은 보장되지 않으므로 관련 없는 결과가 포함될 수 있으며 확인이 필요합니다.
• !JavaScript를 실행하지 않고 페이지를 가져오므로 클라이언트에서 렌더링되는 콘텐츠는 추출되지 않습니다.
• !동시에 검색 요청이 몰리면 DuckDuckGo의 봇 확인에 걸려 요청 빈도가 낮아질 때까지 실패할 수 있습니다. 부하를 분산하려면 프록시가 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

mcp-retrieval은(는) 무엇인가요?

LLM 클라이언트에 API 키 없이 웹 검색, 이미지 검색, 웹페이지의 Markdown 변환을 제공하는 Go 기반 MCP 서버입니다. mcp-retrieval은 Go로 작성된 Model Context Protocol 서버입니다. Claude Desktop이나 IDE 에이전트 같은 MCP 호환 클라이언트에 세 가지 읽기 전용 도구를 제공합니다. 검색어를 조회하는 web_search, 이미지 검색을 위한 web_search_images, 페이지의 주요 기사 내용을 Markdown으로 추출하는 web_scrape입니다.

mcp-retrieval은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mcp-retrieval은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mcp-retrieval은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mcp-retrieval의 마지막 커밋은 2026년 10월 24일입니다.

mcp-retrieval은(는) 어디에 사용할 수 있나요?

검색 API 비용 없이 로컬 LLM 어시스턴트에 실시간 웹 검색 결과를 제공할 수 있습니다. 웹페이지의 기사 내용을 깔끔한 Markdown으로 변환해 모델에 전달할 수 있습니다. 코딩 중 IDE 에이전트가 문서나 최신 정보를 검색하도록 할 수 있습니다. 팀에서 HTTP를 통해 공동으로 사용할 검색 서버를 운영할 수 있습니다.

mcp-retrieval는 어떻게 설치하나요?

소스에서 바이너리를 빌드합니다(Go 1.25.5 이상 필요).: make build 기본 stdio 전송 방식으로 서버를 실행합니다.: ./bin/mcp-retrieval

mcp-retrieval은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Role1776/mcp-retrieval