local-only server
The server can only run on the client’s local machine because it depends on local resources.
Exa MCP 서버 🔍
모델 컨텍스트 프로토콜(MCP) 서버를 통해 클로드와 같은 AI 비서가 Exa AI Search API를 사용하여 웹 검색을 수행할 수 있습니다. 이 설정을 통해 AI 모델은 안전하고 통제된 방식으로 실시간 웹 정보를 얻을 수 있습니다.
데모 영상 https://www.loom.com/share/ac676f29664e4c6cb33a2f0a63772038?sid=0e72619f-5bfc-415d-a705-63d326373f60
MCP란 무엇인가요? 🤔
모델 컨텍스트 프로토콜(MCP)은 Claude Desktop과 같은 AI 앱이 외부 도구 및 데이터 소스에 연결할 수 있도록 하는 시스템입니다. AI 어시스턴트가 사용자의 제어권을 유지하면서 로컬 서비스 및 API를 사용할 수 있는 명확하고 안전한 방법을 제공합니다.
이 서버는 무슨 역할을 하나요? 🚀
Exa MCP 서버:
- Exa의 강력한 검색 API를 사용하여 AI 도우미가 웹 검색을 수행할 수 있도록 합니다.
- 제목, URL, 콘텐츠 스니펫을 포함한 구조화된 검색 결과를 제공합니다.
- 속도 제한 및 오류 사례를 정상적으로 처리합니다.
필수 조건 📋
시작하기 전에 다음 사항을 확인하세요.
- Node.js (v18 이상)
- Claude Desktop 설치됨
- Exa API 키
- Git 설치됨
다음을 실행하여 Node.js 설치를 확인할 수 있습니다.
지엑스피1
설치 🛠️
NPM 설치
대장간 사용
Smithery를 통해 Claude Desktop용 Exa MCP 서버를 자동으로 설치하려면:
수동 설치
- 저장소를 복제합니다.
- 종속성 설치:
- 프로젝트를 빌드하세요:
- 글로벌 링크를 만듭니다(이렇게 하면 서버를 어디서나 실행할 수 있습니다):
구성 ⚙️
1. Exa MCP 서버를 인식하도록 Claude Desktop 구성
Claude Desktop 앱 설정 내부에서 claude_desktop_config.json을 찾을 수 있습니다.
Claude Desktop 앱을 열고 왼쪽 상단 메뉴 표시줄에서 개발자 모드를 활성화하세요.
활성화되면 설정(왼쪽 상단 메뉴 표시줄에서도 가능)을 열고 개발자 옵션으로 이동하면 '구성 편집' 버튼이 있습니다. 이 버튼을 클릭하면 claude_desktop_config.json 파일이 열리고 필요한 편집 작업을 할 수 있습니다.
또는 (터미널에서 claude_desktop_config.json을 열려는 경우)
macOS의 경우:
- Claude Desktop 구성을 엽니다.
Windows의 경우:
- Claude Desktop 구성을 엽니다.
2. Exa 서버 구성을 추가합니다.
your-api-key-here
dashboard.exa.ai/api-keys 의 실제 Exa API 키로 바꾸세요.
3. Claude Desktop을 다시 시작하세요
변경 사항을 적용하려면 다음을 수행하세요.
- Claude Desktop을 완전히 종료합니다(창을 닫는 것만이 아닙니다)
- Claude Desktop을 다시 시작하세요
- Exa 서버가 연결되었는지 확인하려면 🔌 아이콘을 찾으세요.
사용법 🎯
설정이 완료되면 Claude에게 웹 검색을 요청하세요. 다음은 몇 가지 프롬프트 예시입니다.
서버는 다음을 수행합니다.
- 검색 요청을 처리합니다
- Exa API 쿼리
- Claude에게 포맷된 결과를 반환합니다.
- 나중에 참조할 수 있도록 검색 내용을 캐시합니다.
특징 ✨
- 웹 검색 도구 : Claude가 자연어 쿼리를 사용하여 웹을 검색할 수 있도록 합니다.
- 오류 처리 : API 오류 및 속도 제한을 우아하게 처리합니다.
- 유형 안전성 : 적절한 유형 검사를 통한 전체 TypeScript 구현
문제 해결 🔧
일반적인 문제
- 서버를 찾을 수 없습니다
- npm 링크가 올바르게 설정되었는지 확인하세요
- Claude Desktop 구성 구문 확인
- Node.js가 제대로 설치되었는지 확인하세요
- API 키 문제
- Exa API 키가 유효한지 확인하세요
- Claude Desktop 구성에서 API 키가 올바르게 설정되었는지 확인하세요.
- API 키 주위에 공백이나 따옴표가 없는지 확인하세요.
- 연결 문제
- Claude Desktop을 완전히 다시 시작하세요
- Claude Desktop 로그 확인:Copy
도움 받기
문제가 발생하면 MCP 문서를 검토하세요.
감사의 말 🙏
- 강력한 검색 API를 제공하는 Exa AI
- MCP 사양을 위한 모델 컨텍스트 프로토콜
- 클로드 데스크탑을 위한 인류학
This server cannot be installed
Claude와 같은 AI 도우미가 Exa AI Search API를 사용하여 안전하고 통제된 방식으로 실시간 웹 검색을 수행할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.