Yacy Mcp Server
About
MCP (Model Context Protocol) Server implementation that provides AI tools to search using YaCy web search API.
Details
- Author
- koosty
- Downloads
- 258
- Categories
- Search, Other, API, AI
Jump to
- Provides the yacy-search tool for web searches.
- Accepts a required query parameter.
- Supports optional max_results (default 10) and resource (local or global, default global) parameters.
- Configurable YaCy instance URL via YACY_URL environment variable.
- Uses stdio transport for MCP communication.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Yacy Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package using uv sync or uv pip install -e . in the yacy-mcp directory, ensure a YaCy server is running (default at http://localhost:8090), optionally set the YACY_URL environment variable, then run python -m yacy_mcp. For AI applications like Claude Desktop, configure the MCP client with the command uvx yacy_mcp and stdio transport.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"yacy mcp server": {
"yacy-mcp": {
"command": "uvx",
"args": [
"yacy_mcp"
],
"env": {
"YACY_URL": "http://localhost:8090"
}
}
}
}
}McpServers
{
"yacy-mcp": {
"command": "uvx",
"args": [
"yacy_mcp"
],
"env": {
"YACY_URL": "http://localhost:8090"
}
}
}MCP (Model Context Protocol) Server implementation that provides AI tools to search using YaCy web search API.
- Install the package in development mode:
cd yacy-mcp uv sync # Sync all dependencies from pyproject.toml and uv.lock
- Make sure you have a YaCy server running (typically onhttp://localhost:8090)
- Set environment variables (optional):
The server can be configured using environment variables:
- YACY_URL: URL of your YaCy instance (default:http://localhost:8090)
- yacy-search: Search using YaCy web search engine
- Parameters:
- query(string, required): Search query string
- max_results(integer, optional): Maximum number of results to return (default: 10)
- resource(string, optional): Search resource (local or global, default: global)
To use this server with AI applications that support the Model Context Protocol (MCP), configure your MCP client to connect to the server using stdio transport.
Example configuration for Claude Desktop (settings.json):
{ "mcpServers": { "yacy-mcp": { "command": "uvx", "args": ["yacy_mcp"], "env": { "YACY_URL": "http://localhost:8090" } } } }
For other MCP-compatible applications, use the commanduvx yacy_mcpas the server executable. The server will be automatically fetched and run from PyPI.
This MCP server can be used with AI applications that support the Model Context Protocol to perform web searches using the YaCy search engine.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Search the web using Kagi's search API
Multi-provider search broker for AI agents. Routes across SearXNG, Brave, Serper, Tavily, and Exa with automatic fallback, RRF ranking, content extraction, and budget enforcement.
A search server for the Model Context Protocol (MCP) that uses the Baidu Wenxin API.
Perform web, news, and image searches using the Microsoft Bing Search API.
An MCP server for web and local search using the Brave Search API.
Integrates the Brave Search API for both web and local search capabilities. Requires a BRAVE_API_KEY.
An MCP server for the Brave Search API, providing web and local search capabilities via a streaming SSE interface.
An MCP server for the Brave Search API, providing both web and local search capabilities.
Search for cocktail recipes using the cezzis.com API.
Free search API for AI agents — 105 engines, 22 profiles, 94.3% SimpleQA accuracy, MCP server with 5 tools
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
