ddgs-mcp-server 0.1.0__py3-none-any.whl → 0.2.0__py3-none-any.whl

ddgs_mcp_server/server.py

@@ -18,11 +18,17 @@ async def list_tools() -> list[types.Tool]:
     return [
         types.Tool(
             name="search_text",
-            description="Perform a text search using DuckDuckGo. Use this for general web queries.",
+            description="Perform a metasearch using various backends (DuckDuckGo, Google, Bing, etc.). Use this to find APIs, libraries, developer tools, and general information.",
             inputSchema={
                 "type": "object",
                 "properties": {
                     "query": {"type": "string", "description": "Search query"},
+                    "backend": {
+                        "type": "string",
+                        "enum": ["auto", "html", "lite", "bing", "brave", "duckduckgo", "google", "grokipedia", "mojeek", "yandex", "yahoo", "wikipedia"],
+                        "default": "auto",
+                        "description": "Search engine backend to use."
+                    },
                     "region": {"type": "string", "default": "us-en", "description": "e.g., us-en, uk-en"},
                     "safesearch": {"type": "string", "enum": ["on", "moderate", "off"], "default": "moderate"},
                     "timelimit": {"type": "string", "enum": ["d", "w", "m", "y"], "default": None},
@@ -30,63 +36,6 @@ async def list_tools() -> list[types.Tool]:
                 },
                 "required": ["query"]
             }
-        ),
-        types.Tool(
-            name="search_images",
-            description="Perform an image search using DuckDuckGo.",
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "query": {"type": "string"},
-                    "region": {"type": "string", "default": "us-en"},
-                    "safesearch": {"type": "string", "default": "moderate"},
-                    "timelimit": {"type": "string", "default": None},
-                    "max_results": {"type": "integer", "default": 10}
-                },
-                "required": ["query"]
-            }
-        ),
-        types.Tool(
-            name="search_videos",
-            description="Perform a video search using DuckDuckGo.",
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "query": {"type": "string"},
-                    "region": {"type": "string", "default": "us-en"},
-                    "safesearch": {"type": "string", "default": "moderate"},
-                    "timelimit": {"type": "string", "default": None},
-                    "max_results": {"type": "integer", "default": 10}
-                },
-                "required": ["query"]
-            }
-        ),
-        types.Tool(
-            name="search_news",
-            description="Perform a news search using DuckDuckGo.",
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "query": {"type": "string"},
-                    "region": {"type": "string", "default": "us-en"},
-                    "safesearch": {"type": "string", "default": "moderate"},
-                    "timelimit": {"type": "string", "default": None},
-                    "max_results": {"type": "integer", "default": 10}
-                },
-                "required": ["query"]
-            }
-        ),
-         types.Tool(
-            name="search_books",
-            description="Perform a book search using DuckDuckGo (Anna's Archive backend).",
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "query": {"type": "string"},
-                    "max_results": {"type": "integer", "default": 10}
-                },
-                "required": ["query"]
-            }
         )
     ]
 
@@ -94,7 +43,11 @@ async def list_tools() -> list[types.Tool]:
 async def call_tool(name: str, arguments: dict) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:
     logger.info(f"Calling tool: {name} with args: {arguments}")
 
+    if name != "search_text":
+        raise ValueError(f"Unknown tool: {name}")
+
     query = arguments.get("query")
+    backend = arguments.get("backend", "auto")
     region = arguments.get("region", "us-en")
     safesearch = arguments.get("safesearch", "moderate")
     timelimit = arguments.get("timelimit")
@@ -102,23 +55,14 @@ async def call_tool(name: str, arguments: dict) -> list[types.TextContent | type
 
     try:
         with DDGS() as ddgs:
-            results = []
-            if name == "search_text":
-                results = ddgs.text(keywords=query, region=region, safesearch=safesearch, timelimit=timelimit, max_results=max_results)
-            elif name == "search_images":
-                results = ddgs.images(keywords=query, region=region, safesearch=safesearch, timelimit=timelimit, max_results=max_results)
-            elif name == "search_videos":
-                results = ddgs.videos(keywords=query, region=region, safesearch=safesearch, timelimit=timelimit, max_results=max_results)
-            elif name == "search_news":
-                results = ddgs.news(keywords=query, region=region, safesearch=safesearch, timelimit=timelimit, max_results=max_results)
-            elif name == "search_books":
-                if hasattr(ddgs, 'books'):
-                    results = ddgs.books(keywords=query, max_results=max_results)
-                else:
-                    return [types.TextContent(type="text", text="Error: 'books' search backend not available in this version of python-ddgs.")]
-            else:
-                raise ValueError(f"Unknown tool: {name}")
-
+            results = ddgs.text(
+                keywords=query,
+                region=region,
+                safesearch=safesearch,
+                timelimit=timelimit,
+                max_results=max_results,
+                backend=backend
+            )
             return [types.TextContent(type="text", text=json.dumps(results, indent=2))]
 
     except Exception as e:

ddgs_mcp_server-0.2.0.dist-info/METADATA

@@ -0,0 +1,84 @@
+Metadata-Version: 2.4
+Name: ddgs-mcp-server
+Version: 0.2.0
+Summary: DuckDuckGo Search MCP Server
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: duckduckgo-search>=6.0.0
+Requires-Dist: mcp>=1.0.0
+Description-Content-Type: text/markdown
+
+# DDGS MCP Server
+
+A Model Context Protocol (MCP) server that provides DuckDuckGo Search capabilities to AI agents.
+
+## Features
+
+- **search_text**: advanced metasearch using `bing`, `brave`, `duckduckgo`, `google`, `mojeek`, `yahoo`, `yandex`, `wikipedia`.
+
+
+## Installation & Usage
+
+You can run this server directly using `uvx` without installing it globally.
+
+### VS Code (Claude Desktop / Cline)
+
+Add this to your MCP settings file (e.g., `cline_mcp_settings.json` or `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "ddgs-search": {
+      "command": "uvx",
+      "args": [
+        "ddgs-mcp-server"
+      ],
+      "disabled": false,
+      "alwaysAllow": []
+    }
+  }
+}
+```
+
+### Manual Execution
+
+```bash
+uvx ddgs-mcp-server
+```
+
+
+## Secrets & Configuration
+
+This project technically **does not require API keys** to run locally, as it scrapes DuckDuckGo. However, for **publishing** or **proxy usage**, you should configure your environment.
+
+### 1. Set up Secrets
+Copy the example file:
+```bash
+cp .env.example .env
+```
+
+### 2. Required Tokens
+
+| Token | Purpose | How to Get It |
+| :--- | :--- | :--- |
+| **PyPI API Token** | Publishing to PyPI | 1. Go to [PyPI Account Settings](https://pypi.org/manage/account/token/)<br>2. Select "Add API Token"<br>3. Scope to "Entire account" (for first publish)<br>4. Set as `TWINE_PASSWORD` in `.env` |
+| **Proxy URL** | Bypassing Blocks (Optional) | Use any HTTP/SOCKS5 proxy provider if you encounter rate limits. |
+
+## Development / Publishing
+
+To build and publish this package to PyPI (using the secrets from above):
+
+1.  **Build**:
+    ```bash
+    pip install build twine
+    python -m build
+    ```
+
+2.  **Publish** (loads secrets from .env if you export them, or prompts you):
+    ```bash
+    # If using .env variables (PowerShell)
+    # $env:TWINE_USERNAME = "__token__"
+    # $env:TWINE_PASSWORD = "pypi-..."
+
+    python -m twine upload dist/*
+    ```

ddgs_mcp_server-0.2.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+ddgs_mcp_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ddgs_mcp_server/main.py,sha256=hqJl7UoGQoL9a-2hX24srZYFGdatheJfgkn5wz5Od70,492
+ddgs_mcp_server/server.py,sha256=OsDMz-4ZwrZTY6GmPeQpAZhLC_4M5ZPd6coH42V9h0M,2832
+ddgs_mcp_server-0.2.0.dist-info/METADATA,sha256=1Zb3qJOYXgZtCLDmKsIIrE8ESqflZDoE7D8HTkSFylM,2174
+ddgs_mcp_server-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ddgs_mcp_server-0.2.0.dist-info/entry_points.txt,sha256=8YvtzhkNDMvAy2CdIx8VppBFjiBSJ56JtLX-v8SUHGc,62
+ddgs_mcp_server-0.2.0.dist-info/licenses/LICENSE,sha256=vLPKcNOa4dGBRPq4I_mIBKyVSbIlzrOdinbwXFeKb88,1091
+ddgs_mcp_server-0.2.0.dist-info/RECORD,,

ddgs_mcp_server-0.1.0.dist-info/METADATA

@@ -1,65 +0,0 @@
-Metadata-Version: 2.4
-Name: ddgs-mcp-server
-Version: 0.1.0
-Summary: DuckDuckGo Search MCP Server
-License-File: LICENSE
-Requires-Python: >=3.10
-Requires-Dist: duckduckgo-search>=6.0.0
-Requires-Dist: mcp>=1.0.0
-Description-Content-Type: text/markdown
-
-# DDGS MCP Server
-
-A Model Context Protocol (MCP) server that provides DuckDuckGo Search capabilities to AI agents.
-
-## Features
-
-- **Text Search**: General web search (`search_text`)
-- **Image Search**: Find images (`search_images`)
-- **Video Search**: Find videos (`search_videos`)
-- **News Search**: Get latest news (`search_news`)
-- **Book Search**: Search for books (`search_books`)
-
-## Installation & Usage
-
-You can run this server directly using `uvx` without installing it globally.
-
-### VS Code (Claude Desktop / Cline)
-
-Add this to your MCP settings file (e.g., `cline_mcp_settings.json` or `claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "ddgs-search": {
-      "command": "uvx",
-      "args": [
-        "ddgs-mcp-server"
-      ],
-      "disabled": false,
-      "alwaysAllow": []
-    }
-  }
-}
-```
-
-### Manual Execution
-
-```bash
-uvx ddgs-mcp-server
-```
-
-## Development / Publishing
-
-To build and publish this package to PyPI:
-
-1.  **Build**:
-    ```bash
-    pip install build twine
-    python -m build
-    ```
-
-2.  **Publish**:
-    ```bash
-    python -m twine upload dist/*
-    ```

ddgs_mcp_server-0.1.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-ddgs_mcp_server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-ddgs_mcp_server/main.py,sha256=hqJl7UoGQoL9a-2hX24srZYFGdatheJfgkn5wz5Od70,492
-ddgs_mcp_server/server.py,sha256=Zv7v9H7nA1ZY8l8Ltw6OojdkYxj35COZxruY02av3f8,5531
-ddgs_mcp_server-0.1.0.dist-info/METADATA,sha256=ILZeHuWCe4qJm6zW9McrdbiKHjKyF-wplHUlH0XvueU,1356
-ddgs_mcp_server-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-ddgs_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=8YvtzhkNDMvAy2CdIx8VppBFjiBSJ56JtLX-v8SUHGc,62
-ddgs_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=vLPKcNOa4dGBRPq4I_mIBKyVSbIlzrOdinbwXFeKb88,1091
-ddgs_mcp_server-0.1.0.dist-info/RECORD,,