MCP Webresearch

🚀 MCP Web Research Server

A Model Context Protocol (MCP) server designed for web research. Bring real-time information into Claude and easily conduct research on any topic.

🚀 Quick Start

Just start a conversation with Claude and send a prompt that can benefit from web research. If you want to use the customized deep web research prompt in this package we provided, click the paperclip icon in the chat input in Claude Desktop, then select Choose an integration → webresearch → agentic-research.

✨ Features

• Google Search Integration
• Web Content Extraction
• Research Session Tracking (List of visited pages, search queries, etc.)
• Screenshot Capture

📦 Installation

First, make sure you have downloaded and installed the Claude Desktop app, and npm is installed.

Next, add the following content to your claude_desktop_config.json file (on Mac, this file is located at ~/Library/Application\ Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "webresearch": {
      "command": "npx",
      "args": ["-y", "@mzxrai/mcp-webresearch@latest"]
    }
  }
}

This configuration allows Claude Desktop to automatically start the web research MCP server when needed.

💻 Usage Examples

Basic Usage

Just start a conversation with Claude and send a prompt that can benefit from web research.

Advanced Usage

If you want to use the customized deep web research prompt in this package, click the paperclip icon in the chat input in Claude Desktop, then select Choose an integration → webresearch → agentic-research.

Tools

1. search_google

   • Perform a Google search and extract the results
   • Parameters: { query: string }

2. visit_page

   • Visit a web page and extract its content
   • Parameters: { url: string, takeScreenshot?: boolean }

3. take_screenshot

   • Capture a screenshot of the current page
   • No parameters required

Prompts

agentic-research

A guided research prompt to help Claude conduct thorough web research. This prompt instructs Claude to:

• Start with a broad search to understand the topic background
• Prioritize high-quality, authoritative sources
• Refine the research direction step by step based on the findings
• Keep interacting with you and let you guide the research
• Always cite sources with URLs

Resources

We expose two things through MCP resources: (1) captured web page screenshots, and (2) research sessions.

Screenshots

When you capture a screenshot, it is saved as an MCP resource. You can access the captured screenshots through the paperclip icon in Claude Desktop.

Research Sessions

The server maintains a research session, which includes:

• Search queries
• Visited pages
• Extracted content
• Screenshots
• Timestamps

Tips

💡 Usage Tip

For the best results, if you choose not to use the agentic-research prompt for research, suggest Claude to use high-quality sources when researching general topics. For example, you can prompt News from Reuters or AP instead of Today's news.

📚 Documentation

Prerequisites

• Node.js >= 18 (including npm and npx)
• Claude Desktop app installed

🔧 Technical Details

This code is in the pre-release stage and is also generated by AIGC, so there may be errors.

If you encounter problems, checking the MCP logs of Claude Desktop may be helpful:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

🚧 Development

# Download dependencies
npm install

# Start the development server
npm run dev

Contribution Guidelines

Contributions are welcome! Please check CONTRIBUTING.md for more information.

📄 License

[Insert license information here, e.g., MIT License]

📞 Contact

• GitHub: [Your GitHub link]
• Email: [Your email address]