MySearch Proxy
Unified search MCP, proxy console, and skill for Tavily, Firecrawl, and Social / X.
What is MySearch Proxy?
MySearch Proxy is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unified search mcp, proxy console, and skill for tavily, firecrawl, and social / x.
Unified search MCP, proxy console, and skill for Tavily, Firecrawl, and Social / X.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Unified search MCP, proxy console, and skill for Tavily, Fir
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mysearch-proxyConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MySearch Proxy
MySearch Proxy is a unified search MCP server that routes web, documentation, URL extraction, and social media queries to the optimal underlying search provider — Tavily for web and news, Firecrawl for technical documentation and content extraction, and xAI-compatible endpoints for social/X content. It exposes four MCP tools (search, extract_url, research, and mysearch_health) and supports stdio, Server-Sent Events, and streamable HTTP transports, making it usable both as a local MCP server and as a self-hosted Docker service. Developers and researchers use it to avoid managing multiple search API integrations by letting MySearch Proxy intelligently route each query to the best provider.
Prerequisites
- Python 3.10+ for local installation, or Docker for containerized deployment
- A MYSEARCH_PROXY_API_KEY from your self-hosted instance, or credentials for the cloud service
- At least one underlying search API key: Tavily API key, Firecrawl API key, or xAI-compatible endpoint credentials
- An MCP-compatible client such as Claude Desktop, Claude Code, or Cursor
Deploy MySearch Proxy with Docker
The fastest way to get a running instance is with Docker. Set ADMIN_PASSWORD and mount a data volume for persistence. The proxy listens on port 9874.
docker run -d \
--name mysearch-proxy \
--restart unless-stopped \
-p 9874:9874 \
-e ADMIN_PASSWORD=change-me \
-v $(pwd)/mysearch-proxy-data:/app/data \
skernelx/mysearch-proxy:latestConfigure the proxy with your search API keys
After the container starts, access the admin console to configure the underlying provider API keys (Tavily, Firecrawl, xAI). These are stored securely in the mounted data volume.
Install locally (alternative to Docker)
For local development, clone the repository and run the install script to create a virtual environment and install dependencies.
git clone https://github.com/skernelx/MySearch-Proxy.git
cd MySearch-Proxy
python3 -m venv venv
./install.shConfigure your MCP client
Add MySearch Proxy to your MCP client config. Set MYSEARCH_PROXY_BASE_URL to point to your instance and MYSEARCH_PROXY_API_KEY to your generated key.
{
"mcpServers": {
"mysearch-proxy": {
"command": "npx",
"args": ["mysearch-proxy"],
"env": {
"MYSEARCH_PROXY_BASE_URL": "https://your-mysearch-proxy.example.com",
"MYSEARCH_PROXY_API_KEY": "mysp-your-key-here"
}
}
}
}Verify the connection
Use the provided check script to confirm the proxy is reachable and all configured providers are responding.
python3 skill/scripts/check_mysearch.py --health-only
python3 skill/scripts/check_mysearch.py --web-query "OpenAI latest announcements"MySearch Proxy Examples
Client configuration
Full MCP config pointing to a self-hosted MySearch Proxy instance with optional parallelism and cache tuning.
{
"mcpServers": {
"mysearch-proxy": {
"command": "npx",
"args": ["mysearch-proxy"],
"env": {
"MYSEARCH_PROXY_BASE_URL": "https://your-mysearch-proxy.example.com",
"MYSEARCH_PROXY_API_KEY": "mysp-your-key-here",
"MYSEARCH_MAX_PARALLEL_WORKERS": "4",
"MYSEARCH_SEARCH_CACHE_TTL_SECONDS": "30",
"MYSEARCH_EXTRACT_CACHE_TTL_SECONDS": "300"
}
}
}
}Prompts to try
These prompts exercise the four MySearch Proxy tools across web search, content extraction, and combined research workflows.
- "Search the web for the latest news about OpenAI model releases"
- "Extract the full content from https://docs.python.org/3/library/asyncio.html"
- "Research the current state of AI search engines and summarize the top 3 findings"
- "Search X/Twitter for recent posts about Model Context Protocol"
- "Check MySearch Proxy health and show which providers are currently active"Troubleshooting MySearch Proxy
MYSEARCH_PROXY_API_KEY is not recognized or returns 401 Unauthorized
Generate the API key from the MySearch Proxy admin console after deployment. Keys have the prefix 'mysp-'. Verify that MYSEARCH_PROXY_BASE_URL matches the protocol (http vs https) and port of your instance.
Social/X search returns no results
Social search requires an xAI-compatible API endpoint configured in the proxy admin. Ensure you have set up an xAI API key or compatible social search endpoint in the proxy configuration panel.
Docker container starts but port 9874 is not reachable
Check that no other process is using port 9874 with 'lsof -i :9874'. If running behind a firewall or on a remote server, ensure the port is open. Verify the container is running with 'docker ps' and check logs with 'docker logs mysearch-proxy'.
Frequently Asked Questions about MySearch Proxy
What is MySearch Proxy?
MySearch Proxy is a Model Context Protocol (MCP) server that unified search mcp, proxy console, and skill for tavily, firecrawl, and social / x. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MySearch Proxy?
Follow the installation instructions on the MySearch Proxy GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MySearch Proxy?
MySearch Proxy works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MySearch Proxy free to use?
Yes, MySearch Proxy is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MySearch Proxy Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to MySearch Proxy? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MySearch Proxy in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MySearch Proxy?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.