The OneSearch MCP Server is a Model Context Protocol (MCP) server implementation designed to integrate with search engines and web scrapers like Searxng, Firecrawl, and Tavily. It provides robust web search, crawling, scraping, and content extraction capabilities, making it a powerful tool for developers and researchers.
one_search
and one_scrape
for seamless integration.You can install the OneSearch MCP Server globally or run it directly using npx
.
# Manually install (Optional)
npm install -g one-search-mcp
# using npx
env SEARCH_API_URL=http://127.0.0.1:8080 FIRECRAWL_API_URL=http://127.0.0.1:3002 npx -y one-search-mcp
SEARCH_PROVIDER
: Choose between searxng
or tavily
(default: searxng
).SEARCH_API_URL
: Required for searxng
.SEARCH_API_KEY
: Required for tavily
.FIRECRAWL_API_URL
: Required for firecrawl
.FIRECRAWL_API_KEY
: Required for Firecrawl cloud service.Add the following configuration to your mcp.json
file:
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": ["-y", "one-search-mcp"],
"env": {
"SEARCH_PROVIDER": "searxng",
"SEARCH_API_URL": "http://127.0.0.1:8080",
"SEARCH_API_KEY": "YOUR_API_KEY",
"FIRECRAWL_API_URL": "http://127.0.0.1:3002",
"FIRECRAWL_API_KEY": "YOUR_API_KEY"
}
}
}
}
Add this to your ./codeium/windsurf/model_config.json
file:
{
"mcpServers": {
"one-search-mcp": {
"command": "npx",
"args": ["-y", "one-search-mcp"],
"env": {
"SEARCH_PROVIDER": "searxng",
"SEARCH_API_URL": "http://127.0.0.1:8080",
"SEARCH_API_KEY": "YOUR_API_KEY",
"FIRECRAWL_API_URL": "http://127.0.0.1:3002",
"FIRECRAWL_API_KEY": "YOUR_API_KEY"
}
}
}
}
For local deployment of Searxng and Firecrawl, refer to the Deploy guide.
This project is licensed under the MIT License. See the LICENSE file for details.
The OneSearch MCP Server is a versatile tool for integrating web search and scraping capabilities into your projects. It is actively maintained and supported by the community.