MCP Web Search Server

웹 검색 기능을 제공하는 Model Context Protocol(MCP) 서버로서, Render에 배포할 수 있습니다.

Python과 공식 MCP SDK를 기반으로 제작되었으며, AIPI, Claude Desktop 등 다양한 MCP 클라이언트와의 최대 호환성을 위해 SSE(Server-Sent Events) 전송을 지원합니다.

노출되는 도구

Related MCP server: MCP Search & Fetch

🚀 Render에 배포하기(단계별)

1. 이 저장소를 GitHub에 푸시하세요

cd mcp-web-search
git init
git add .
git commit -m "Initial commit"
# create a repo on github.com, then:
git remote add origin https://github.com/YOUR_USERNAME/mcp-web-search.git
git push -u origin main

2. Render에서 새 웹 서비스 만들기

1. render.com으로 이동 → 새로 만들기 → 웹 서비스

2. GitHub 저장소(mcp-web-search)를 연결하세요

3. Render가 render.yaml을 자동으로 감지합니다 — 적용을 클릭하세요

4. Render 대시보드에서 환경 변수를 설정하세요:

5. 웹 서비스 만들기를 클릭 — Render가 자동으로 빌드하고 배포합니다.

서버 URL은 https://mcp-web-search.onrender.com(또는 유사한 주소)이 됩니다.

🔌 AIPI에 연결

AIPI의 "사용자 지정 MCP 추가" 대화 상자에 다음 구성을 붙여넣으세요:

{
  "mcpServers": {
    "web-search": {
      "type": "sse",
      "url": "https://YOUR-SERVICE.onrender.com/sse"
    }
  }
}

YOUR-SERVICE를 실제 Render 서비스 이름(예: mcp-web-search-j73g)으로 바꾸세요.

기타 MCP 클라이언트

SSE 전송을 지원하는 모든 MCP 클라이언트에서 작동합니다:

Claude Desktop(claude_desktop_config.json):

{
  "mcpServers": {
    "web-search": {
      "type": "sse",
      "url": "https://YOUR-SERVICE.onrender.com/sse"
    }
  }
}

🔍 검색 공급자

Serper를 사용하려면 Render 환경 변수에 SERPER_API_KEY를 설정하세요. 키가 없으면 서버가 자동으로 DuckDuckGo로 대체됩니다.

🧪 로컬에서 테스트

pip install -r requirements.txt
SERPER_API_KEY=your_key python server.py

상태 확인:

curl http://localhost:3000/

서버는 기본적으로 포트 3000에서 실행됩니다. PORT 환경 변수를 설정하면 변경할 수 있습니다.

⚠️ 무료 티어 참고

Render의 무료 티어는 15분간 비활성 상태가 지속되면 종료됩니다(콜드 스타트 약 30초). 항상 켜 두려면 **Starter 플랜($7/월)**으로 업그레이드하세요.