duck-poacher-mcp
Provides web and image search capabilities using DuckDuckGo's search engine.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@duck-poacher-mcp search the web for recipes for gluten-free pasta"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
duck-poacher-mcp
A Model Context Protocol server that exposes
DuckDuckGo web and image search to MCP clients (Claude Desktop, Claude Code, and
others). It wraps the duck-poacher
scraper.
Tools
Tool | Arguments | Returns |
|
| JSON array of |
|
| JSON array of |
Both tools return their results as a JSON string. A failed
scrape (token/URL could not be read, upstream HTTP error) comes back as a tool
result with isError: true and the message.
Related MCP server: DuckDuckGo MCP Server
Use with an MCP client
Run the published binary over stdio. With Claude Code:
claude mcp add duck-poacher -- npx -y duck-poacher-mcpOr configure it directly (e.g. Claude Desktop's claude_desktop_config.json):
{
"mcpServers": {
"duck-poacher": {
"command": "npx",
"args": ["-y", "duck-poacher-mcp"]
}
}
}LM Studio
Edit LM Studio's mcp.json (Program tab → Edit mcp.json) and add the same entry:
{
"mcpServers": {
"duck-poacher": {
"command": "npx",
"args": ["-y", "duck-poacher-mcp"]
}
}
}Develop
npm install
npm test # live integration specs — hit DuckDuckGo, need network
npm run build # bundle to dist/ (ESM), bin → dist/cli.mjsInspect the tools interactively with the MCP Inspector:
npm run build
npx @modelcontextprotocol/inspector node dist/cli.mjsSee .claude/documentation/ for the code-style
and testing conventions this project follows.
License
ISC © Lars Dreier
Available Tools
2 toolsimage_searchDuckDuckGo image searchA
Search for images via DuckDuckGo. Returns a page of results, each with an image URL and a thumbnail URL, plus pagination metadata. Supports optional filters for time, size, color, type, layout, and license. Results are cached for an hour; request later pages of the same query and filters with page to read more without re-searching.
Inputs: query (required), page, size, time, +5 more.
web_searchDuckDuckGo web searchA
Search the web via DuckDuckGo. Returns a page of results, each with a title, URL, and description, plus pagination metadata. Results are cached for an hour; request later pages of the same query with page to read more without re-searching.
Inputs: query (required), page.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools are clearly distinct: one returns text results, the other returns image results. There is no overlap in purpose or output.
Both tools follow a consistent verb_noun pattern (web_search, image_search), making their actions and targets immediately clear.
With only two tools covering web and image search, the count is minimal but not unreasonable for a focused search server. It feels slightly thin but not extreme.
The tool set covers basic text and image search, but lacks common search types like news or video. The absence of these creates notable gaps for a general-purpose search server.
Maintenance
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
MCP server for Google search results via SERP API
Unofficial Serper MCP — wraps the Serper Google Search API (serper.dev)
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.320,901 PyPI1,584MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI applications like Claude Desktop and Cursor IDE to perform web searches via DuckDuckGo's search engine.-
- AlicenseNot gradedqualityDmaintenanceSmall Python MCP server that provides web search and page fetching tools via DuckDuckGo, requiring no API key.Apache 2.0
- AlicenseAqualityDmaintenanceMCP server that enables web search, image search, and image download using DuckDuckGo.3MIT