Opendeepsearch

🚀 OpenDeepSearch

An open-source alternative to Perplexity for in-depth research, utilizing the Model Context Protocol (MCP).

🚀 Quick Start

OpenDeepSearch is a powerful research tool capable of conducting comprehensive and in - depth studies on complex topics. It combines the structured thinking method of sequential thinking with the search capabilities of Brave Search to provide detailed and well - supported research reports.

✨ Features

• Comprehensive Research: Breaks down complex topics into manageable sub - questions.
• Iterative Search: Performs multiple searches to obtain diverse information.
• Intelligent Analysis: Analyzes search results to extract relevant information.
• Synthesis: Integrates findings into a coherent and structured report.
• Citation: Includes the sources of all information in the report.
• MCP Integration: Seamlessly integrates with Claude Desktop, Cursor, and other MCP clients.
• WebSocket Support: Supports integration with Smithery and other MCP clients.
• Publication: Allows the research tool to be published on the Smithery platform for easy access.

📦 Installation

Prerequisites

• Node.js version 16 or higher.
• Brave Search API key (Get it from: https://brave.com/search/api/).

NPM Installation

npm install -g open-deep-research

Run with NPX

BRAVE_API_KEY=your_api_key npx open-deep-research

Local Installation

# 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

Installation via 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

When installing via Smithery, you will be prompted to enter your Brave Search API key.

💻 Usage Examples

Usage with Claude Desktop

Add the following content to your Claude Desktop configuration:

{
  "mcpServers": {
    "open-deep-research": {
      "command": "npx",
      "args": [
        "-y",
        "open-deep-research"
      ],
      "env": {
        "BRAVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage with Cursor

In Cursor, you can use the following command to add an MCP server:

claude mcp add "open-deep-research" npx open-deep-research

Make sure to set the BRAVE_API_KEY environment variable before running Cursor.

Example Queries

• "Current development of advanced artificial intelligence"
• "Solutions to global climate change"
• "Latest progress in quantum computing"

📚 Documentation

Testing with Claude or Cursor

After installing via Smithery or locally, you can select the corresponding MCP server for configuration in Claude Desktop or Cursor.

Publishing to Smithery

To publish the server on the Smithery platform:

1. Ensure that the repository is hosted on GitHub and is public.
2. Register on the Smithery platform.
3. Use GitHub authentication to connect the repository.
4. Go to the "Deploy" tab.
5. Click the "Deploy on Smithery" button.
6. Follow the deployment setup guide.

After publishing, users can install the server using the following command:

npx @smithery/cli install open-deep-research --client claude