RAG 웹 브라우저 Actor를 위한 모델 컨텍스트 프로토콜(MCP) 서버 🌐

RAG 웹 브라우저 액터 용 MCP 서버 구현. 이 액터는 ChatGPT의 웹 검색과 유사하게 대규모 언어 모델(LLM) 및 RAG 파이프라인을 위한 웹 브라우저 역할을 합니다.

🎯 이 MCP 서버는 무슨 역할을 하나요?

이 서버는 AI 에이전트와 LLM에 빠른 응답을 제공하도록 특별히 설계되어 웹과 상호 작용하고 웹 페이지에서 정보를 추출할 수 있도록 합니다. 로컬에서 실행되며 대기 모드 에서 RAG 웹 브라우저 액터 와 통신하여 검색 쿼리를 전송하고 추출된 웹 콘텐츠를 응답으로 받습니다.

RAG 웹 브라우저 액터를 사용하면 AI 비서가 다음을 수행할 수 있습니다.

• 웹 검색을 수행하고 결과에서 상위 N개 URL을 스크래핑하고 정리된 콘텐츠를 마크다운으로 반환합니다.
• 단일 URL을 가져와서 해당 콘텐츠를 마크다운으로 반환합니다.

🧱 구성 요소

도구

• 검색 : Google 검색을 쿼리하고, 결과에서 상위 N개의 URL을 스크래핑하여 정리된 콘텐츠를 마크다운으로 반환합니다. 인수:
  • query (문자열, 필수): 검색어 또는 URL
  • maxResults (숫자, 선택 사항): 스크래핑할 최대 검색 결과 수(기본값: 1)
  • scrapingTool (문자열, 선택 사항): 웹 페이지 추출을 위한 스크래핑 도구를 선택합니다. 옵션: 'browser-playwright' 또는 'raw-http'(기본값: 'raw-http')
  • outputFormats (배열, 선택 사항): 출력 형식을 하나 이상 선택합니다. 옵션: 'text', 'markdown', 'html' (기본값: ['markdown'])
  • requestTimeoutSecs (숫자, 선택 사항): 요청에 대한 최대 시간(초)(기본값: 40)

🔄 모델 컨텍스트 프로토콜이란 무엇인가요?

모델 컨텍스트 프로토콜(MCP)은 Claude Desktop과 같은 AI 애플리케이션이 외부 도구 및 데이터 소스와 원활하게 연결될 수 있도록 하는 프레임워크입니다. 자세한 내용은 모델 컨텍스트 프로토콜 웹사이트를 방문하거나 "MCP란 무엇이며 왜 중요한가?"라는 블로그 게시물을 참조하세요.

🤖 MCP 서버는 AI 에이전트와 어떻게 통합되나요?

MCP 서버는 AI 에이전트가 RAG 웹 브라우저 액터를 사용하여 웹 검색 및 브라우징을 수행할 수 있도록 지원합니다. AI 에이전트에 대한 자세한 내용은 블로그 게시물 " AI 에이전트란 무엇인가?"를 참조하고 Apify 에이전트 에 대해 자세히 알아보세요.

Apify에서 나만의 AI 에이전트를 구축하고 수익을 창출하는 데 관심이 있으신가요? Apify 플랫폼에서 AI 에이전트를 생성, 게시하고 수익을 창출하는 단계별 가이드를 확인해 보세요.

🔌 Apify의 관련 MCP 서버 및 클라이언트

이 서버는 표준 입출력(stdio)을 통해 작동하여 AI 에이전트와의 간편한 연결을 제공합니다. Apify는 다음과 같은 여러 MCP 관련 도구를 제공합니다.

서버 옵션

• 🖥️ 이 MCP 서버는 Claude Desktop과 직접 통합하기 위한 로컬 stdio 기반 서버입니다.
• 🌐 SSE를 통한 RAG 웹 브라우저 액터 – 로컬 서버를 실행하지 않고 서버에서 보낸 이벤트를 통해 RAG 웹 브라우저에 직접 액세스
• 🇦 MCP 서버 액터 – AI 에이전트에게 4,000개 이상의 전문화된 Apify 액터 에 대한 액세스를 제공하는 MCP 서버

클라이언트 옵션

• 💬 테스터 MCP 클라이언트 – SSE 기반 MCP 서버와 상호 작용하기 위한 사용자 친화적인 UI

🛠️ 구성

필수 조건

• MacOS 또는 Windows
• Claude Desktop의 최신 버전을 설치해야 합니다(또는 다른 MCP 클라이언트)
• Node.js (v18 이상)
• Apify API 토큰 ( APIFY_TOKEN )

설치하다

로컬 머신에 서버를 설정하고 실행하려면 아래 단계를 따르세요. 먼저 다음 명령을 사용하여 저장소를 복제하세요.

지엑스피1

프로젝트 디렉토리로 이동하여 필요한 종속성을 설치합니다.

서버를 실행하기 전에 프로젝트를 빌드해야 합니다.

클로드 데스크탑

Claude Desktop이 MCP 서버를 인식하도록 구성합니다.

1. Claude Desktop 구성을 열고 다음 파일을 편집하세요.
   • macOS의 경우: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json
   "mcpServers": { "rag-web-browser": { "command": "npx", "args": [ "@apify/mcp-server-rag-web-browser" ], "env": { "APIFY_TOKEN": "your-apify-api-token" } } }
2. Claude Desktop을 다시 시작하세요
   • Claude Desktop을 완전히 종료합니다(최소화되거나 닫힌 상태가 아닌지 확인하세요).
   • Claude Desktop을 다시 시작합니다.
   • 서버가 연결되었는지 확인하려면 🔌 아이콘을 찾으세요.
3. 예시Claude에게 다음과 같은 웹 검색을 수행하도록 요청할 수 있습니다.
   What is an MCP server and how can it be used? What is an LLM, and what are the recent news updates? Find and analyze recent research papers about LLMs.

MCP Inspector를 사용하여 서버 디버깅

👷🏼 개발

로컬 클라이언트(stdio)

서버를 로컬로 테스트하려면 example_client_stdio.ts 사용할 수 있습니다.

스크립트는 MCP 서버를 시작하고, 사용 가능한 도구를 가져온 다음 쿼리를 사용하여 search 도구를 호출합니다.

직접 API 호출

RAG 웹 브라우저 액터를 직접 호출하는 것을 테스트하려면:

디버깅

MCP 서버는 표준 입출력(stdio)을 통해 작동하므로 디버깅이 어려울 수 있습니다. 최상의 디버깅 환경을 위해서는 MCP Inspector를 사용하세요.

mcp-server-rag-web-browser 패키지를 빌드합니다.

다음 명령을 사용하여 npm 통해 MCP Inspector를 시작할 수 있습니다.

Inspector를 실행하면 브라우저에서 접근하여 디버깅을 시작할 수 있는 URL이 표시됩니다.