Deep Research MCP

Setup

1. **Clone the Repository:** ```bash git clone https://github.com/yourusername/deep-research-mcp.git cd deep-research-mcp ```

2. **Create/Populate Your `.env` File:** ```bash cp .env.example .env # Then edit the new .env file to fill in your secrets and environment variables # For example: # OPENAI_API_KEY=sk-123-yourkey # Additional environment variables can be placed here ```

3. **Install Dependencies:** ```bash pip install -r multi_agents/requirements.txt ```

4. Edit your `claude_desktop_config.json` file to include the following: ``` { "mcpServers": { "deep-research-mcp": { "command": "path/to/your/python/interpreter", "args": [ "/path/to/this/project/deep-research-mcp/mcp_server.py" ] } } } ```

5. **Run the MCP Server:** ```bash python mcp_server.py ``` This starts the FastMCP tool server locally. From here, any MCP-compatible client or the CLI can invoke the `deep_research` tool.

Project Overview

• **multi_agents** - **agents**: Contains the various AI agents (ResearchAgent, EditorAgent, etc.). - **memory**: Typed dictionaries to store research and draft states. - **main.py**: Core logic to load tasks and orchestrate agents. - **README.md**: Additional instructions on usage, file output settings, etc.

• **mcp_server.py**: Main FastMCP server file (entrypoint).

• **utils**: Shared functions and enums used across the codebase.

• **.gitignore**, **requirements.txt**, etc.: Standard setup files.