into-the-night/deep-research-mcp

Deep Research MCP

This is a sample MCP server used to showcase MCP's integrative capabilites. It includes two tools: generate_plan and execute_plan.

Built with 🛠

• FastMCP
• LangChain
• Groq

How to run 🏃🏻‍♂️

1. Clone the repository:

   git clone https://github.com/into-the-night/deep-research-mcp.git
   cd deep-research-mcp
   

2. Install uv:

   For Windows-

   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

   For MacOS/Linux-

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

3. Create a virtual environment and activate it:

   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

4. Install dependencies:

   uv pip install -e .
   

5. Create a .env file and populate it with:

   TAVILY_API_KEY=<YOUR_TAVILY_API_KEY>
   GROQ_API_KEY=<YOUR_GROQ_API_KEY>
   

6. Run the app:

   uv run app.py
   

Use with Claude Desktop 💻

1. Download Claue Desktop: https://claude.ai/download

2. Copy and paste this into claude_desktop_config.json:

   {
       "mcpServers": {
           "deep_research": {
               "command": "uv",
               "args": [
                   "--directory",
                   "ABSOLUTE\PATH\TO\REPO",
                   "run",
                   "app.py"
               ]
           }
       }
   }
   

3. Restart Claude Desktop

Note: If you still can't see the server inside the app, make sure Claude gets completely restarted as it might still be running in system tray.

Author ✍

Made with ♥ by Abhay Shukla

License 📜

This project is licensed under the MIT License - see the file for details.