ddgs-mcp-server 0.3.0__py3-none-any.whl

ddgs_mcp_server/main.py

@@ -0,0 +1,20 @@
+
+import asyncio
+import sys
+from mcp.server.stdio import stdio_server
+from .server import server
+
+async def run():
+    async with stdio_server() as (read_stream, write_stream):
+        await server.run(read_stream, write_stream, server.create_initialization_options())
+
+def main():
+    try:
+        asyncio.run(run())
+    except KeyboardInterrupt:
+        pass
+    except Exception as e:
+        print(f"Error: {e}", file=sys.stderr)
+
+if __name__ == "__main__":
+    main()

ddgs_mcp_server/server.py

@@ -0,0 +1,96 @@
+
+import json
+import logging
+from typing import Optional, Literal
+from mcp.server import Server
+import mcp.types as types
+from duckduckgo_search import DDGS
+
+# Logging Configuration
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("ddgs-mcp")
+
+# MCP Server
+server = Server("ddgs-mcp-server")
+
+@server.list_tools()
+async def list_tools() -> list[types.Tool]:
+    return [
+        types.Tool(
+            name="search_text",
+            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},
+                    "max_results": {"type": "integer", "default": 10}
+                },
+                "required": ["query"]
+            }
+        ),
+        types.Tool(
+            name="search_news",
+            description="Perform a news search to find the latest updates, releases, or security alerts.",
+            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"]
+            }
+        )
+    ]
+
+@server.call_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 not in ["search_text", "search_news"]:
+        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")
+    max_results = arguments.get("max_results", 10)
+
+    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,
+                    backend=backend
+                )
+            elif name == "search_news":
+                results = ddgs.news(
+                    keywords=query,
+                    region=region,
+                    safesearch=safesearch,
+                    timelimit=timelimit,
+                    max_results=max_results
+                )
+
+            return [types.TextContent(type="text", text=json.dumps(results, indent=2))]
+
+    except Exception as e:
+        logger.error(f"Error executing {name}: {e}")
+        return [types.TextContent(type="text", text=f"Error performing search: {str(e)}")]

ddgs_mcp_server-0.3.0.dist-info/METADATA

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: ddgs-mcp-server
+Version: 0.3.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`.
+- **search_news**: Find latest updates, releases, and tech news.
+
+
+## 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.3.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=8Uqw88N80Bgr-gyvaHkG8btOnJt_fm3dG2D4H8s1oiA,3938
+ddgs_mcp_server-0.3.0.dist-info/METADATA,sha256=5-zLeJnqv_6UYNvWEfo3GLLWS-CUKyiN9IH3F0TkgA4,2239
+ddgs_mcp_server-0.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ddgs_mcp_server-0.3.0.dist-info/entry_points.txt,sha256=8YvtzhkNDMvAy2CdIx8VppBFjiBSJ56JtLX-v8SUHGc,62
+ddgs_mcp_server-0.3.0.dist-info/licenses/LICENSE,sha256=vLPKcNOa4dGBRPq4I_mIBKyVSbIlzrOdinbwXFeKb88,1091
+ddgs_mcp_server-0.3.0.dist-info/RECORD,,

ddgs_mcp_server-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

ddgs_mcp_server-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ddgs-mcp-server = ddgs_mcp_server.main:main

ddgs_mcp_server-0.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chirag Singhal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.