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
| Tool | Description | Parameters |
|---|---|---|
web_search | Search the web for information | query (required), maxResults (optional, 1-20) |
extract_content | Extract content from a URL | url (required) |
deep_research | Comprehensive multi-source research | query (required), depth (optional, 1-5) |
news_search | Search for news articles | query (required), maxResults (optional, 1-20) |
academic_search | Search academic/research content | query (required), maxResults (optional, 1-20) |
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
- Fork this repository
- Import to Vercel
- 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
| Endpoint | Description |
|---|---|
GET/POST /api/mcp | MCP server endpoint |
GET /.well-known/oauth-protected-resource | OAuth metadata (for authenticated setups) |
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
| Variable | Description | Required |
|---|---|---|
NEXT_PUBLIC_APP_URL | Public URL of your deployment | No |
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:
