Create app.py

app.py

@@ -0,0 +1,86 @@
+import os
+import gradio as gr
+from duckduckgo_search import DDGS
+
+
+def web_search(
+    query: str,
+    max_results: int = 5,
+    region: str = "wt-wt",
+    safesearch: str = "moderate",
+    timelimit: str | None = None,
+):
+    """
+    Search the web using DuckDuckGo and return the top results.
+
+    Args:
+        query: Search query string.
+        max_results: Maximum number of results to return (1-25 recommended).
+        region: DDG region (e.g. "wt-wt" global, "us-en", "ca-en", "uk-en").
+        safesearch: "off", "moderate", or "strict".
+        timelimit: Optional time filter: "d" (day), "w" (week), "m" (month), "y" (year), or None.
+
+    Returns:
+        A list of results, each with title, url, and snippet.
+    """
+    q = (query or "").strip()
+    if not q:
+        return []
+
+    max_results = int(max(1, min(max_results, 25)))
+
+    results = []
+    # DDGS returns dicts with keys like: title, href, body
+    with DDGS() as ddgs:
+        for r in ddgs.text(
+            q,
+            region=region,
+            safesearch=safesearch,
+            timelimit=timelimit,
+            max_results=max_results,
+        ):
+            results.append(
+                {
+                    "title": r.get("title"),
+                    "url": r.get("href"),
+                    "snippet": r.get("body"),
+                }
+            )
+    return results
+
+
+with gr.Blocks(title="Web Search (MCP-ready)") as demo:
+    gr.Markdown(
+        """
+# Web Search (DuckDuckGo) — UI + MCP Tool
+- Use the UI below, or connect as an MCP server from your agent/editor.
+- The MCP endpoint appears in the Space footer → **View API** → **MCP**.
+"""
+    )
+
+    with gr.Row():
+        query = gr.Textbox(label="Query", placeholder="e.g. gradio mcp server hugging face spaces")
+    with gr.Row():
+        max_results = gr.Slider(1, 25, value=5, step=1, label="Max results")
+        region = gr.Dropdown(
+            choices=["wt-wt", "us-en", "ca-en", "uk-en", "au-en", "de-de", "fr-fr", "es-es", "it-it"],
+            value="wt-wt",
+            label="Region",
+        )
+        safesearch = gr.Dropdown(choices=["off", "moderate", "strict"], value="moderate", label="SafeSearch")
+        timelimit = gr.Dropdown(choices=[None, "d", "w", "m", "y"], value=None, label="Time limit")
+
+    run_btn = gr.Button("Search")
+    out = gr.JSON(label="Results (title/url/snippet)")
+
+    run_btn.click(
+        fn=web_search,
+        inputs=[query, max_results, region, safesearch, timelimit],
+        outputs=out,
+        api_name="web_search",  # nicer MCP tool name
+        queue=False,            # optional: reduces MCP progress overhead
+    )
+
+if __name__ == "__main__":
+    # Gradio will expose MCP endpoints when mcp_server=True
+    demo.launch(mcp_server=True, server_name="0.0.0.0", server_port=int(os.getenv("PORT", "7860")))