Deep Search MCP Server

A production-ready Model Context Protocol (MCP) server providing comprehensive deep search capabilities including web search, content extraction, and AI-powered research.

Features

• Web Search - Search the web for any topic with comprehensive results

• Content Extraction - Extract clean, readable content from any URL

• Deep Research - Multi-source research with summaries and key findings

• News Search - Find recent news articles on any topic

• Academic Search - Discover academic papers and research content

Quick Start

Connect to Your AI Assistant

Add this configuration to your MCP client (e.g., Cursor, Claude Desktop):

{
  "mcpServers": {
    "deep-search": {
      "url": "https://deep-search-mcp.vercel.app/api/mcp"
    }
  }
}

For Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "deep-search": {
      "url": "https://deep-search-mcp.vercel.app/api/mcp"
    }
  }
}

Available Tools

Self-Hosting

Prerequisites

• Node.js 20+

• npm, yarn, or pnpm

Installation

# Clone the repository
git clone https://github.com/LikhonSheikh404/deep-search-mcp.git
cd deep-search-mcp

# Install dependencies
npm install

# Copy environment file
cp .env.example .env

# Start development server
npm run dev

Deploy to Vercel

1. Fork this repository

2. Import to Vercel

3. Deploy!

Or use the CLI:

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

Testing with MCP Inspector

npx @modelcontextprotocol/inspector@latest http://localhost:3000

Then open http://127.0.0.1:6274 to test your tools.

API Endpoints

Technology Stack

• Framework: Next.js 15 (App Router)

• Language: TypeScript

• MCP SDK: mcp-handler

• Deployment: Vercel (Serverless + Fluid Compute)

• Transport: Streamable HTTP (efficient, no persistent connections)

Architecture

src/
├── app/
│   ├── api/
│   │   └── [transport]/
│   │       └── route.ts      # MCP server endpoint
│   ├── .well-known/
│   │   └── oauth-protected-resource/
│   │       └── route.ts      # OAuth metadata
│   ├── page.tsx              # Landing page
│   └── layout.tsx            # Root layout
├── lib/
│   └── search-engine.ts      # Search functionality
└── types/
    └── mcp.ts                # Type definitions

Environment Variables

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - feel free to use this in your own projects.

Author

Built by Matrix Agent

Resources:

• MCP Documentation

• Vercel MCP Guide

• Next.js Documentation