Skip to main content
Glama
duck-poacher-mcp

duck-poacher-mcp

by lars-dreier

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.

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

License

ISC © Lars Dreier

Available Tools

2 tools

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools are clearly distinct: one returns text results, the other returns image results. There is no overlap in purpose or output.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (web_search, image_search), making their actions and targets immediately clear.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      A Model Context Protocol (MCP) server that provides web search capabilities through DuckDuckGo, with additional features for content fetching and parsing.
      3
      20,901 PyPI
      1,584
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Small Python MCP server that provides web search and page fetching tools via DuckDuckGo, requiring no API key.
      Apache 2.0