Research Multi API Search

🚀 Research MCP

A research tool that combines the Model Context Protocol (MCP) with tools like Brave Search and Tavily Search, aiming to achieve a function similar to ChatGPT's DeepResearch.

✨ Features

• Web Search: Conduct web searches via Claude Desktop using Brave and Tavily Search APIs.
• MCP Protocol: Fully compliant with the Model Context Protocol standard.
• Caching Mechanism: Search results are cached to improve performance and reduce API calls.

📦 Installation

Local Development Setup

1. Install Deno.
2. Clone the repository.
3. Set environment variables:
   • BRAVE_API_KEY: Brave Search API key.
   • TAVILY_API_KEY: Tavily Search API key (optional).
4. Run the application:

make dev  # Start the HTTP server
make mcp  # Start the MCP server for Claude Desktop

Container Environment Setup

1. Install Docker and Docker Compose.
2. Set environment variables in the .env file.
3. Build and run the container:

make d-build
make d-up

💻 Usage Examples

Development Commands

# Local development
make dev     # Start the HTTP server with watch mode
make mcp     # Start the MCP server for Claude Desktop
make test    # Run tests
make lint    # Run the code checker
make format  # Format the code
make check   # Type checking

# Docker development
make d-build  # Build the image
make d-dev    # Start the container with live reload
make d-up     # Run in the background
make d-logs   # View logs
make d-down   # Stop the container

Integration with Claude Desktop's MCP

1. Run the MCP server: make mcp.
2. Add a new MCP server in Claude Desktop with the following configuration:

{
    "mcpServers": {
        "MCPSearch": {
            "description": "Web search powered by Brave, Tavily, etc.",
            "command": "/absolute/path/to/ResearchMCP/cli.ts",
            "args": [],
            "transport": "stdio",
            "env": {
                "BRAVE_API_KEY": "Your Brave API key",
                "TAVILY_API_KEY": "Your Tavily API key"
            }
        }
    }
}

Please replace /absolute/path/to/ResearchMCP/cli.ts with the actual path to the cli.ts file.

Known Limitations

⚠️ Important Note

The Brave Search API has limited support for non-Latin characters. Searching in languages using non-Latin alphabets such as Japanese, Chinese, and Korean may result in encoding errors. It is recommended to use English queries for the best results.

🔧 Technical Details