Deep Web Research Server

🚀 MCP Depth

MCP Depth is a tool designed for executing complex network tasks and search operations. It supports functions such as parallel search, web page access, and content extraction.

🚀 Quick Start

MCP Depth is a powerful tool that enables users to perform complex network tasks and search operations efficiently. It offers features like parallel search, web page access, and content extraction.

✨ Features

Core Features

1. Deep Search

   • Conduct multiple Google searches.
   • Support intelligent queue management.
   • Limit the maximum number of parallel searches to 5 for stable performance.

2. Web Page Access

   • Visit specified URLs and extract content.
   • Return formatted text in Markdown format.

💻 Usage Examples

Deep Search Interface

{
  type: 'parallel_search';
  args: {
    queries: string[];
    maxParallel?: number;
  };
}

Example of the returned results:

[
  {
    query: "Query Term 1";
    results: [
      { url: "Link 1", title: "Title 1", snippet: "Excerpt 1" },
      // Other results...
    ]
  },
  // Results of multiple queries...
]

Web Page Access Interface

{
  type: 'visit_page';
  args: { url: string };
}

Example of the returned results:

{
  url: "https://example.com",
  title: "Example Page Title",
  content: "# Example Content\n This is the main content of the web page..."
}

📚 Documentation

Configuration Options

Configure through environment variables:

• MAX_PARALLEL_SEARCHES - Maximum number of parallel searches, default is 5.
• SEARCH_DELAY_MS - Delay between searches in milliseconds, default is 200ms.
• MAX_RETRIES - Number of request retries, default is 3.
• TIMEOUT_MS - Request timeout in milliseconds, default is 55000ms.
• LOG_LEVEL - Log level, default is 'info'.

Error Handling

Common Issues

1. Rate Limiting

   • Symptom: "Too many requests" error.
   • Solution: Increase SEARCH_DELAY_MS or reduce MAX_PARALLEL_SEARCHES.

2. Network Timeout

   • Symptom: "Request timed out" error.
   • Solution: Ensure requests are completed within the 60 - second MCP timeout limit.

3. Browser Issues

   • Symptom: "Browser failed to launch" error.
   • Solution: Ensure Playwright is correctly installed (run npx playwright install).

🔧 Technical Details

Project Setup

# Install dependencies
pnpm install

# Build the project
pnpm build

# Monitor changes
pnpm watch

# Run in development mode
pnpm dev

Testing Guide

# Run all tests
pnpm test

# Run tests in watch mode
pnpm test:watch

# Run tests with coverage report
pnpm test:coverage

Code Quality

# Run code linting tool
pnpm lint

# Automatically fix code issues
pnpm lint:fix

# Type checking
pnpm type - check

🤝 Contribution Guidelines

1. Create a feature branch

   git checkout -b feature/amazing - feature
   

2. Commit changes

   git commit -m 'Add amazing feature'
   

3. Push to the remote repository

   git push origin feature/amazing - feature
   

4. Submit a pull request

Coding Standards

• Follow TypeScript best practices.
• Maintain a test coverage of over 80%.
• Keep documentation clear and easy to understand.
• Ensure code maintainability.

📄 License

This project is developed and maintained by [Your Name/Company] and is licensed under the MIT License.

This document covers the main features, usage methods, and development guidelines of the MCP Depth tool. For further assistance, please refer to the official documentation or contact the support team.