클로드 웹 검색 MCP 서버

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

특징

• Claude의 웹 검색 API를 사용한 웹 검색 도구

• 도메인 필터링 지원(허용 및 차단된 도메인)

• 검색당 구성 가능한 최대 결과

• Claude Desktop 구성 파일에서 자동 구성

Related MCP server: Google Search MCP

필수 조건

• 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