웹 검색 MCP 서버

AI 어시스턴트에게 실시간 웹 검색 기능을 제공하는 지속적인 Model Context Protocol (MCP) 서버를 실행하는 Apify Actor입니다. Claude Desktop, Cursor 또는 MCP 호환 AI 클라이언트를 연결하여 워크플로우를 벗어나지 않고 웹을 검색하세요.

주요 기능

• 🔍 search_web — DuckDuckGo(무료, 키 불필요) 또는 Brave Search(고품질)를 통한 웹 검색

• 📰 search_news — 최신 뉴스 기사 검색

• 📄 fetch_page — 모든 URL에서 깔끔한 텍스트 콘텐츠를 가져와 추출

• 🔐 도메인 화이트리스트 — 승인된 도메인으로 fetch_page 제한

• 📊 감사 로그 — 모든 검색 기록을 Apify 데이터셋에 선택적으로 기록

• ⚡ 상시 가동 — Apify Standby 모드에서 실행되어 24/7 지속적인 가용성 제공

Related MCP server: Local Research MCP Server

빠른 시작

1. Apify에서 실행

1. Apify 콘솔로 이동하여 이 액터를 찾습니다.

2. Try for free를 클릭 → 입력을 구성 → Start를 클릭합니다.

3. 액터 실행 로그에서 Standby URL을 복사합니다 (예: https://web-search-mcp.username.apify.actor).

2. Claude Desktop에 연결

Claude Desktop의 claude_desktop_config.json에 다음을 추가하세요:

{
  "mcpServers": {
    "web-search": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR-STANDBY-URL/sse"]
    }
  }
}

Claude Desktop을 재시작하면 인터페이스에 도구가 나타납니다.

3. Cursor / 기타 MCP 클라이언트에 연결

SSE URL을 다음과 같이 설정하세요: https://YOUR-STANDBY-URL/sse

입력 구성

MCP 도구 참조

search_web

웹을 검색하고 순위가 매겨진 결과를 가져옵니다.

매개변수:

• query (string, 필수) — 검색 쿼리

• maxResults (integer, 선택, 기본값: 10) — 결과 수 (1–50)

• safeSearch (enum, 선택) — strict, moderate 또는 off

반환값: 제목, URL, 스니펫이 포함된 순위가 매겨진 결과 목록.

search_news

최신 뉴스 기사를 검색합니다.

매개변수:

• query (string, 필수) — 뉴스 검색 쿼리

• maxResults (integer, 선택) — 기사 수 (1–20)

반환값: 게시 시간이 포함된 뉴스 기사 목록 (사용 가능한 경우).

fetch_page

웹 페이지를 가져와 깔끔한 텍스트 콘텐츠를 반환합니다.

매개변수:

• url (string, 필수) — 가져올 전체 URL

• maxLength (integer, 선택, 기본값: 8000) — 최대 문자 수 (500–50000)

반환값: 페이지 제목, 메타 설명 및 추출된 본문 텍스트.

API 엔드포인트

아키텍처

AI Client (Claude, Cursor, etc.)
        │ SSE connection
        ▼
  Express HTTP Server (:3000)
        │
  MCP Server (McpServer)
        │
  ┌─────┴──────────┐
  │   Search Tools  │
  └─────┬──────────┘
        │
  ┌─────┴─────────────────────┐
  │ DuckDuckGo HTML API        │ (default, no key needed)
  │ Brave Search REST API      │ (optional, with API key)
  └────────────────────────────┘

로컬 개발

git clone https://github.com/your-org/web-search-mcp
cd web-search-mcp
npm install
npm start

서버가 http://localhost:3000에서 시작됩니다. 모든 MCP 클라이언트를 http://localhost:3000/sse에 연결하세요.

사용 예시 (Claude에서)

연결되면 Claude에게 다음과 같이 물어볼 수 있습니다:

"유럽의 AI 규제에 관한 최신 뉴스를 검색해줘"

"2025년 최고의 파이썬 웹 프레임워크는 무엇인가요? 웹을 검색하고 요약해줘."

"https://example.com/blog/post 의 콘텐츠를 가져와서 핵심 내용을 요약해줘."

라이선스

Apache 2.0 — LICENSE 참조