server.py

"""MCP server for DuckDuckGo web searches, compatible with AgentCore Runtime."""

from mcp.server.fastmcp import FastMCP
from ddgs import DDGS

mcp = FastMCP(
    "ddgs-search",
    instructions=(
        "Web search using DuckDuckGo. Use ddgs_search for general queries "
        "and ddgs_news for recent news."
    ),
    host="0.0.0.0",
    port=8000,
    stateless_http=True,
)


@mcp.tool()
def ddgs_search(query: str, max_results: int = 10, region: str = "wt-wt") -> list[dict]:
    """Search the web using DuckDuckGo.

    Args:
        query: Search query string
        max_results: Maximum number of results (default 10)
        region: Region code (default "wt-wt" for worldwide). Examples: "us-en", "uk-en", "de-de"
    """
    with DDGS() as ddgs:
        results = list(ddgs.text(query, max_results=max_results, region=region))
    return results


@mcp.tool()
def ddgs_news(query: str, max_results: int = 10, region: str = "wt-wt", timelimit: str | None = None) -> list[dict]:
    """Search recent news using DuckDuckGo.

    Args:
        query: News search query
        max_results: Maximum number of results (default 10)
        region: Region code (default "wt-wt" for worldwide)
        timelimit: Time limit - "d" (day), "w" (week), "m" (month), or None for all
    """
    with DDGS() as ddgs:
        results = list(ddgs.news(query, max_results=max_results, region=region, timelimit=timelimit))
    return results


if __name__ == "__main__":
    mcp.run(transport="streamable-http")