웹 검색 MCP 서버

API 키가 필요 없이 Google 검색 결과를 사용하여 무료 웹 검색을 구현하는 MCP(Model Context Protocol) 서버입니다.

특징

지엑스피1

npm run build

VSCode(Claude Dev Extension)의 경우:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

Claude Desktop의 경우:

{
  "mcpServers": {
    "web-search": {
      "command": "node",
      "args": ["/path/to/web-search/build/index.js"]
    }
  }
}

서버는 다음 매개변수를 허용하는 search 이라는 단일 도구를 제공합니다.

{
  "query": string,    // The search query
  "limit": number     // Optional: Number of results to return (default: 5, max: 10)
}

사용 예:

use_mcp_tool({
  server_name: "web-search",
  tool_name: "search",
  arguments: {
    query: "your search query",
    limit: 3  // optional
  }
})

응답 예시:

[
  {
    "title": "Example Search Result",
    "url": "https://example.com",
    "description": "Description of the search result..."
  }
]

이 도구는 Google 검색 결과의 웹 스크래핑을 사용하므로 알아야 할 몇 가지 중요한 제한 사항이 있습니다.

속도 제한 : Google은 짧은 시간 내에 너무 많은 검색이 수행될 경우 요청을 일시적으로 차단할 수 있습니다. 이를 방지하려면 다음을 수행하세요.
- 검색 빈도를 적정 수준으로 유지하세요
- 제한 매개변수를 신중하게 사용하세요
- 필요한 경우 검색 사이에 지연을 구현하는 것을 고려하세요.
결과 정확도 :
- 이 도구는 Google의 HTML 구조에 의존하며 이는 변경될 수 있습니다.
- 일부 결과에는 설명이나 기타 메타데이터가 누락되었을 수 있습니다.
- 복잡한 검색 연산자는 예상대로 작동하지 않을 수 있습니다.
법적 고려 사항 :
- 이 도구는 개인용으로 사용됩니다.
- Google 서비스 약관을 준수하세요
- 사용 사례에 적합한 속도 제한을 구현하는 것을 고려하세요.

문제점과 개선 요청을 자유롭게 제출하세요!