Metadata-Version: 2.4
Name: abe-deep-research
Version: 0.1.1
Summary: A MCP server for deep research and report generation
Author-email: Xing Xing <xing@readingplus.ai>
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# MCP Server for Deep Research

MCP Server for Deep Research is a tool designed for conducting comprehensive research on complex topics. It helps you explore questions in depth, find relevant sources, and generate structured research reports.

Your personal Research Assistant, turning research questions into comprehensive, well-cited reports.

## 🚀 Try it Out

[![Watch the demo](https://img.youtube.com/vi/_a7sfo5yxoI/maxresdefault.jpg)]([VIDEO_URL](https://youtu.be/_a7sfo5yxoI))
Youtube: https://youtu.be/_a7sfo5yxoI

1. **Download Claude Desktop**
   - Get it [here](https://claude.ai/download)

2. **Install and Set Up**
   - On macOS, run the following command in your terminal:
   ```bash
   python setup.py
   ```

3. **Start Researching**
   - Select the deep-research prompt template from MCP
   - Begin your research by providing a research question

## Features

The Deep Research MCP Server offers a complete research workflow:

1. **Question Elaboration**
   - Expands and clarifies your research question
   - Identifies key terms and concepts
   - Defines scope and parameters

2. **Subquestion Generation**
   - Creates focused subquestions that address different aspects
   - Ensures comprehensive coverage of the main topic
   - Provides structure for systematic research

3. **Web Search Integration**
   - Uses Claude's built-in web search capabilities
   - Performs targeted searches for each subquestion
   - Identifies relevant and authoritative sources
   - Collects diverse perspectives on the topic

4. **Content Analysis**
   - Evaluates information quality and relevance
   - Synthesizes findings from multiple sources
   - Provides proper citations for all sources

5. **Report Generation**
   - Creates well-structured, comprehensive reports as artifacts
   - Properly cites all sources used
   - Presents a balanced view with evidence-based conclusions
   - Uses appropriate formatting for clarity and readability

## 📦 Components

### Prompts
- **deep-research**: Tailored for comprehensive research tasks with a structured approach

## ⚙️ Modifying the Server

### Claude Desktop Configurations
- macOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%/Claude/claude_desktop_config.json`

### Development (Unpublished Servers)
```json
"mcpServers": {
  "mcp-server-deep-research": {
    "command": "uv",
    "args": [
      "--directory",
      "/Users/username/repos/mcp-server-application/mcp-server-deep-research",
      "run",
      "mcp-server-deep-research"
    ]
  }
}
```

### Published Servers
```json
"mcpServers": {
  "mcp-server-deep-research": {
    "command": "uvx",
    "args": [
      "mcp-server-deep-research"
    ]
  }
}
```

## 🛠️ Development

### Building and Publishing
1. **Sync Dependencies**
   ```bash
   uv sync
   ```

2. **Build Distributions**
   ```bash
   uv build
   ```
   Generates source and wheel distributions in the dist/ directory.

3. **Publish to PyPI**
   ```bash
   uv publish
   ```

## 🤝 Contributing

Contributions are welcome! Whether you're fixing bugs, adding features, or improving documentation, your help makes this project better.

## 📜 License

This project is licensed under the MIT License.
See the LICENSE file for details.
