오픈딥서치
MCP(Model Context Protocol)를 사용하는 Perplexity Deep Research의 오픈 소스 대안입니다.
개요
OpenDeepSearch는 복잡한 주제에 대한 포괄적이고 심층적인 연구를 수행하는 강력한 연구 도구입니다. Sequential Thinking의 구조적 사고 방식과 Brave Search의 검색 기능을 결합하여 상세하고 출처가 명확한 연구 보고서를 제공합니다.
특징
- 종합 연구 : 복잡한 질문을 관리 가능한 하위 질문으로 분류합니다.
- 반복 검색 : 다양한 정보를 수집하기 위해 여러 번의 검색을 수행합니다.
- 지능형 분석 : 검색 결과를 분석하여 관련 정보를 추출합니다.
- 종합 : 결과를 일관되고 잘 구성된 보고서로 결합합니다.
- 인용 : 보고서의 모든 정보에 대한 출처를 포함합니다.
- MCP 통합 : Claude Desktop, Cursor 및 기타 MCP 클라이언트와 원활하게 통합됩니다.
- WebSockets : Smithery 및 기타 MCP 클라이언트와의 통합을 지원합니다.
- 게시 : Smithery 플랫폼에 연구 도구를 게시하여 쉽게 액세스할 수 있도록 합니다.
설치
필수 조건
NPM 설치
지엑스피1
NPX로 실행
BRAVE_API_KEY=your_api_key npx open-deep-research
로컬 설치
# Clone the repository
git clone https://github.com/tositon/open-deep-research.git
cd open-deep-research
# Install dependencies
npm install
# Build the project
npm run build
# Run with Brave Search API
BRAVE_API_KEY=your_api_key npm start
Smithery를 통한 설치
# Install for Claude
npx @smithery/cli install open-deep-research --client claude
# Install for Cursor
npx @smithery/cli install open-deep-research --client cursor
Smithery를 통해 설치하는 경우 Brave Search API 키를 입력하라는 메시지가 표시됩니다.
용법
클로드 데스크톱과 함께
Claude Desktop 구성에 다음을 추가하세요.
{
"mcpServers": {
"open-deep-research": {
"command": "npx",
"args": [
"-y",
"open-deep-research"
],
"env": {
"BRAVE_API_KEY": "your_api_key_here"
}
}
}
}
커서 포함
Cursor에서 다음을 사용하여 MCP 서버를 추가할 수 있습니다.
claude mcp add "open-deep-research" npx open-deep-research
Cursor를 실행하기 전에 BRAVE_API_KEY 환경 변수를 설정해야 합니다.
예제 쿼리
- "양자 컴퓨팅의 최신 개발 동향은 무엇입니까?"
- "기후 변화 완화에 대한 다양한 접근 방식을 비교하고 대조하세요"
- "르네상스가 유럽 미술에 미친 영향과 역사를 설명하세요"
- "다양한 재생 에너지원의 장단점은 무엇입니까?"
작동 원리
- 질문 분석 : 시스템은 주요 질문을 분석하고 이를 하위 질문으로 분류합니다.
- 반복 검색 : 각 하위 질문에 대해 시스템은 Brave Search API를 사용하여 검색을 수행합니다.
- 결과 분석 : 시스템은 검색 결과를 분석하여 관련 정보를 추출합니다.
- 합성 : 시스템은 결과를 일관된 보고서로 결합합니다.
- 인용 : 모든 정보는 출처와 함께 적절하게 인용되었습니다.
개발
설정
git clone https://github.com/tositon/open-deep-research.git
cd open-deep-research
npm install
짓다
개발 모드에서 실행
BRAVE_API_KEY=your_api_key npm run dev
테스트
MCP Inspector로 테스트
MCP Inspector에 대한 자세한 내용은 MCP 서버의 MCP Inspector에서 확인하세요. 설명:
# Установка и запуск MCP Inspector
npx @modelcontextprotocol/inspector
# Запуск сервера в другом терминале
BRAVE_API_KEY=your_api_key npm start
После запуска Inspector, откройте браузер 및 перейдите по адресу http://localhost:5173 . WebSocket серверу, используя URL ws://localhost:3000 확인하세요.
Primеры запросов для тестирования инструmentов
MCP Inspector에 대한 정보는 다음과 같습니다.
Brave Web Search 테스트
{
"query": "latest quantum computing advancements",
"count": 5
}
순차적 사고 테스트
{
"thought": "Начинаю анализ проблемы глобального потепления",
"thoughtNumber": 1,
"totalThoughts": 5,
"nextThoughtNeeded": true
}
심층 연구 테스트
{
"query": "Сравнение различных источников возобновляемой энергии",
"action": "start",
"maxSubQuestions": 3
}
Claude 또는 Cursor로 테스트
이 서버는 Smithery 또는 локально, вы можете использовать его с Claude Desktop 및 Cursor, выбрав соответствушерий MCP сервер в настройках.
Smithery에 게시
Smithery 플랫폼에 서버를 게시하려면:
- 저장소가 GitHub에 호스팅되고 공개되어 있는지 확인하세요.
- Smithery 플랫폼에 등록하세요
- GitHub를 통해 인증하여 저장소에 연결합니다.
- 서버 페이지의 "배포" 탭으로 이동하세요
- "Smithery에 배포" 버튼을 클릭하세요
- 배포 설정 지침을 따르세요
게시 후 사용자는 Smithery CLI를 사용하여 서버를 설치할 수 있습니다.
npx @smithery/cli install open-deep-research --client claude
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
감사의 말
- Perplexity Deep Research에서 영감을 받음
- 모델 컨텍스트 프로토콜을 기반으로 구축됨
- 구조화된 연구를 위해 순차적 사고 접근 방식을 사용합니다.
- Brave Search API 지원