MCP Nexus
A unified search and extraction MCP server hosted on Cloudflare Workers that integrates Tavily and Brave Search APIs with automatic API key rotation. It features secure, encrypted storage for keys using Cloudflare D1 and provides an admin interface f
What is MCP Nexus?
MCP Nexus is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to unified search and extraction mcp server hosted on cloudflare workers that integrates tavily and brave search apis with automatic api key rotation. it features secure, encrypted storage for keys using...
A unified search and extraction MCP server hosted on Cloudflare Workers that integrates Tavily and Brave Search APIs with automatic API key rotation. It features secure, encrypted storage for keys using Cloudflare D1 and provides an admin interface f
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A unified search and extraction MCP server hosted on Cloudfl
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-nexusConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Nexus
MCP Nexus is a self-hosted, unified search and extraction MCP server that runs on Cloudflare Workers or Docker and aggregates Tavily, Brave Search, and Grok APIs behind a single MCP endpoint. It includes automatic API key rotation, encrypted key storage via Cloudflare D1 or PostgreSQL, per-client token auth, and a web admin UI for managing keys and monitoring usage.
Prerequisites
- Node.js 18+ and npm installed for local development
- Docker and Docker Compose for the recommended self-hosted setup
- At least one search API key: Tavily (https://tavily.com) or Brave Search (https://brave.com/search/api/)
- A 32-byte hex string for KEY_ENCRYPTION_SECRET (generate with: openssl rand -hex 32)
- A bearer token value for ADMIN_API_TOKEN to protect the admin interface
Clone the repository
Clone the mcp-nexus repository to your local machine and copy the example environment file.
git clone https://github.com/xydong-web/mcp-nexus.git
cd mcp-nexus
cp .env.example .envConfigure environment variables
Edit the .env file with your admin token, encryption secret, and database settings. All other variables have sensible defaults.
# .env
ADMIN_API_TOKEN=your-secure-admin-token
KEY_ENCRYPTION_SECRET=your-32-byte-hex-string
DATABASE_URL=postgresql://mcp_nexus:mcp_nexus_dev@localhost:5432/mcp_nexus?schema=public
HOST=0.0.0.0
PORT=8787
SEARCH_SOURCE_MODE=brave_prefer_tavily_fallbackStart the server with Docker Compose
Use Docker Compose to build and start the MCP Nexus server along with the PostgreSQL database.
docker compose up --buildAdd API keys via the admin UI
Open the admin interface in your browser. Navigate to the API Keys section and add your Tavily and/or Brave Search API keys. Keys are stored encrypted and rotated automatically.
# Admin UI (running locally)
open http://localhost:8787/admin
# MCP endpoint
# http://localhost:8787/mcpCreate a client token
In the admin UI, create a client token for your MCP client. This token is used to authenticate requests from Claude or other AI clients.
# Via admin UI: Admin → Client Tokens → Create New Token
# Copy the generated token for use in your MCP client configConfigure your MCP client
Add MCP Nexus to your Claude Desktop or other MCP client config using the stdio-http-bridge package, which bridges stdio MCP protocol to the HTTP endpoint.
{
"mcpServers": {
"mcp-nexus": {
"command": "npx",
"args": ["-y", "@mcp-nexus/stdio-http-bridge"],
"env": {
"TAVILY_BRIDGE_BASE_URL": "http://localhost:8787",
"TAVILY_BRIDGE_MCP_TOKEN": "<your-client-token>"
}
}
}
}MCP Nexus Examples
Client configuration
Claude Desktop configuration using the stdio-http-bridge to connect to a locally running MCP Nexus instance.
{
"mcpServers": {
"mcp-nexus": {
"command": "npx",
"args": ["-y", "@mcp-nexus/stdio-http-bridge"],
"env": {
"TAVILY_BRIDGE_BASE_URL": "http://localhost:8787",
"TAVILY_BRIDGE_MCP_TOKEN": "your-client-token-here"
}
}
}
}Prompts to try
Search and extraction prompts you can send to Claude once MCP Nexus is connected.
- "Search the web for the latest news about Rust programming language"
- "Use Brave local search to find coffee shops near downtown Seattle"
- "Extract the main content from https://example.com/article"
- "Crawl https://docs.example.com and summarize the getting started section"
- "Search for 'MCP server best practices' and give me a summary of the top 5 results"Troubleshooting MCP Nexus
Admin UI returns 401 Unauthorized
Ensure the Authorization header is set to 'Bearer <your-ADMIN_API_TOKEN>' when accessing the admin API directly. The admin UI in the browser should prompt for this token. Verify the ADMIN_API_TOKEN in your .env matches what you're using.
Search tools return no results or API errors
Check that at least one API key (Tavily or Brave) has been added via the admin UI and is valid. Verify SEARCH_SOURCE_MODE in .env matches which keys you have configured. Set to 'tavily_only', 'brave_only', or 'brave_prefer_tavily_fallback'.
npx @mcp-nexus/stdio-http-bridge fails to connect
Confirm the Docker container is running and accessible at the URL in TAVILY_BRIDGE_BASE_URL. Check that your client token was created in the admin UI and ENABLE_QUERY_AUTH is set to true if you want to enforce tokens. Try accessing http://localhost:8787/mcp directly to verify the server is up.
Frequently Asked Questions about MCP Nexus
What is MCP Nexus?
MCP Nexus is a Model Context Protocol (MCP) server that unified search and extraction mcp server hosted on cloudflare workers that integrates tavily and brave search apis with automatic api key rotation. it features secure, encrypted storage for keys using cloudflare d1 and provides an admin interface f It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Nexus?
Follow the installation instructions on the MCP Nexus GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Nexus?
MCP Nexus works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Nexus free to use?
Yes, MCP Nexus is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Nexus Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to MCP Nexus? 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 MCP Nexus 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 MCP Nexus?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.