웹 검색 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 서비스 약관을 준수하세요
- 사용 사례에 적합한 속도 제한을 구현하는 것을 고려하세요.

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

security - not tested

license - not tested

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

API 키가 필요 없이 Google 검색 결과를 사용하여 무료 웹 검색을 지원하고 제목, URL, 설명이 포함된 구조화된 결과를 반환합니다.

Web Search MCP Server