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 | |------|-----------|---------| | web_search | query | JSON array of { title, url, description } | | image_search | query, optional time / size / color / type / layout / license / safeSearch | JSON array of { thumbnailUrl, imageUrl } |
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.
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
