Claude Web Search MCP Server

클로드 웹 검색 MCP 서버

이 MCP(Model Context Protocol) 서버는 Claude API를 사용하여 웹 검색 기능을 제공합니다. LLM은 표준화된 인터페이스를 통해 웹에서 최신 정보에 접근할 수 있습니다.

특징

• Claude의 웹 검색 API를 사용한 웹 검색 도구
• 도메인 필터링 지원(허용 및 차단된 도메인)
• 검색당 구성 가능한 최대 결과
• Claude Desktop 구성 파일에서 자동 구성

필수 조건

• Node.js 18 이상
• 웹 검색이 활성화된 Anthropic API 키
• 테스트용 Claude Desktop 앱

설치 및 설정

1. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install
3. 서버를 빌드하세요:
   npm run build
   이렇게 하면 TypeScript 코드가 컴파일되고 서버가 실행 가능하게 됩니다.
4. 글로벌 액세스를 위해 서버를 연결하세요:
   npm link
   이렇게 하면 mcp-server-claude-search 명령을 시스템 전체에서 사용할 수 있고, Claude Desktop 앱에서 해당 명령을 찾을 수 있습니다.

Claude Desktop App으로 서버 실행

서버가 설치되고 연결되면 Claude Desktop 앱이 올바르게 구성된 경우 서버를 자동으로 관리할 수 있습니다.

1. Claude Desktop 앱 구성: Claude Desktop 앱의 MCP 서버 구성 파일(일반적으로 claude_desktop_config.json )을 엽니다. 이 서버에 대한 항목을 추가하거나 업데이트합니다.
   { "mcpServers": { // ... other servers ... "claude-search": { "command": "mcp-server-claude-search", "env": { "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE" } } // ... other servers ... } }
   "YOUR_ANTHROPIC_API_KEY_HERE" 실제 Anthropic API 키로 바꾸세요. env 변수가 여기에 설정되어 있지 않으면 서버는 ~/code/claude-search-mcp/claude_desktop_config.json 파일에서도 이 키를 읽으려고 시도하지만, 기본 설정에서 서버별로 키를 정의하는 것이 좋습니다.
2. Claude 데스크톱 앱 실행: Claude 데스크톱 애플리케이션을 시작(또는 재시작)하세요. 이제 필요할 때 mcp-server-claude-search 찾아 실행할 수 있습니다.
3. 웹 검색 사용: 이제 클로드와의 대화에서 웹 검색 기능을 사용할 수 있습니다.

수동 서버 실행(테스트/개발용)

테스트나 개발 목적으로 서버를 수동으로 실행하려는 경우(Claude Desktop 앱 관리 외부):

• 전역적으로 연결된 명령을 사용합니다.
  mcp-server-claude-search
• tsx를 사용하여 직접(자동 재시작을 통한 개발의 경우):
  npm run dev
• 컴파일된 코드를 직접 실행합니다.
  npm start

웹 검색 도구 매개변수

LLM에서 호출할 때 웹 검색 도구는 다음 매개변수를 지원합니다.

• query (필수): 검색 쿼리 문자열.
• maxResults (선택 사항): 반환할 검색 결과의 최�� 개수(기본값: 5).
• allowedDomains (선택 사항): 검색 결과에 포함할 도메인 배열(예: ["example.com", "wikipedia.org"] ).
• blockedDomains (선택 사항): 검색 결과에서 제외할 도메인 배열입니다.

특허

MIT