README

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-mcp

Or 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.mjs

Inspect the tools interactively with the MCP Inspector:

npm run build
npx @modelcontextprotocol/inspector node dist/cli.mjs

See .claude/documentation/ for the code-style and testing conventions this project follows.

duck-poacher-mcp

README

duck-poacher-mcp

Tools

Use with an MCP client

LM Studio

Develop

License

Recommended Servers