skydeckai-code 0.1.27__tar.gz → 0.1.29__tar.gz

skydeckai_code-0.1.27/README.md → skydeckai_code-0.1.29/PKG-INFO

@@ -1,6 +1,42 @@
+Metadata-Version: 2.4
+Name: skydeckai-code
+Version: 0.1.29
+Summary: This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval.
+Project-URL: Homepage, https://github.com/skydeckai/skydeckai-code
+Project-URL: Repository, https://github.com/skydeckai/skydeckai-code
+Project-URL: Documentation, https://github.com/skydeckai/skydeckai-code/blob/main/README.md
+Author-email: "SkyDeck.ai" <support@skydeck.ai>
+License: Apache 2.0
+License-File: LICENSE
+Keywords: ai,aidd,code,code-analysis,development,mcp
+Requires-Python: >=3.11
+Requires-Dist: beautifulsoup4>=4.13.3
+Requires-Dist: gitpython>=3.1.44
+Requires-Dist: html2text>=2025.4.15
+Requires-Dist: mcp>=1.6.0
+Requires-Dist: mss>=10.0.0
+Requires-Dist: pillow>=11.1.0
+Requires-Dist: psutil>=7.0.0
+Requires-Dist: pygetwindow>=0.0.9
+Requires-Dist: pyobjc-framework-quartz>=11.0
+Requires-Dist: requests>=2.32.3
+Requires-Dist: tree-sitter-c-sharp>=0.23.1
+Requires-Dist: tree-sitter-cpp>=0.23.4
+Requires-Dist: tree-sitter-go>=0.23.4
+Requires-Dist: tree-sitter-java>=0.23.5
+Requires-Dist: tree-sitter-javascript>=0.23.1
+Requires-Dist: tree-sitter-kotlin>=1.1.0
+Requires-Dist: tree-sitter-php>=0.23.11
+Requires-Dist: tree-sitter-python>=0.23.6
+Requires-Dist: tree-sitter-ruby>=0.23.1
+Requires-Dist: tree-sitter-rust==0.23.2
+Requires-Dist: tree-sitter-typescript>=0.23.2
+Requires-Dist: tree-sitter>=0.24.0
+Description-Content-Type: text/markdown
+
 # SkyDeckAI Code
 
-An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
+An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
 
 # Formerly Known As MCP-Server-AIDD
 
@@ -10,28 +46,9 @@ This mcp server was formerly known as `mcp-server-aidd`. It was renamed to `skyd
 
 ## Installation
 
-### Installing via Smithery
-
-To install SkyDeckAI Code for Claude Desktop automatically via [Smithery](https://smithery.ai/server/skydeckai-code):
-
-```bash
-npx -y @smithery/cli install skydeckai-code --client claude
-```
-
-### Installing via McpGet
-
-```bash
-npx @michaellatman/mcp-get@latest install skydeckai-code
-```
-
-### Manual Installation
-
 ```bash
 # Using pip
 pip install skydeckai-code
-
-# Using uv
-uvx skydeckai-code
 ```
 
 ## Claude Desktop Setup
@@ -63,7 +80,8 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 -   Code content searching with regex pattern matching
 -   Multi-language code execution with safety measures
 -   Git operations (status, diff, commit, branch management, cloning)
--   Web content fetching from APIs and websites
+-   Web content fetching from APIs and websites with HTML-to-markdown conversion
+-   Multi-engine web search with reliable fallback mechanisms
 -   Batch operations for parallel and serial tool execution
 -   Security controls with configurable workspace boundaries
 -   Screenshot and screen context tools
@@ -536,6 +554,53 @@ skydeckai-code-cli --tool web_fetch --args '{
 }'
 ```
 
+#### web_search
+
+Performs a robust web search using multiple search engines and returns concise, relevant results.
+
+```json
+{
+    "query": "latest python release features",
+    "num_results": 8,
+    "convert_html_to_markdown": true,
+    "search_engine": "bing"
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| query | string | Yes | The search query to process. Be specific for better results. |
+| num_results | integer | No | Maximum number of search results to return (default: 10, max: 20) |
+| convert_html_to_markdown | boolean | No | When true, content will be converted from HTML to markdown for better readability (default: true) |
+| search_engine | string | No | Specifies which search engine to use: "auto" (default), "bing", or "duckduckgo" |
+
+**Returns:**
+A list of search results formatted in markdown, including titles, URLs, and snippets for each result. Results are deduplicated and organized hierarchically for easy reading.
+
+This tool uses a multi-engine approach that tries different search engines with various parsing strategies to ensure reliable results. You can specify a preferred engine, but some engines may block automated access, in which case the tool will fall back to alternative engines when "auto" is selected.
+
+**Example Usage:**
+
+```bash
+# Search with default settings (auto engine selection)
+skydeckai-code-cli --tool web_search --args '{
+    "query": "latest python release features"
+}'
+
+# Try DuckDuckGo if you want alternative results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "machine learning frameworks comparison",
+    "search_engine": "duckduckgo"
+}'
+
+# Use Bing for reliable results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "best programming practices 2023",
+    "search_engine": "bing"
+}'
+```
+
 ### Utility Tools
 
 #### batch_tools

skydeckai_code-0.1.27/PKG-INFO → skydeckai_code-0.1.29/README.md

@@ -1,41 +1,6 @@
-Metadata-Version: 2.4
-Name: skydeckai-code
-Version: 0.1.27
-Summary: This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching, code content searching, and system information retrieval.
-Project-URL: Homepage, https://github.com/skydeckai/skydeckai-code
-Project-URL: Repository, https://github.com/skydeckai/skydeckai-code
-Project-URL: Documentation, https://github.com/skydeckai/skydeckai-code/blob/main/README.md
-Author-email: "SkyDeck.ai" <support@skydeck.ai>
-License: Apache 2.0
-License-File: LICENSE
-Keywords: ai,aidd,code,code-analysis,development,mcp
-Requires-Python: >=3.11
-Requires-Dist: gitpython>=3.1.44
-Requires-Dist: html2text>=2025.4.15
-Requires-Dist: mcp>=1.6.0
-Requires-Dist: mss>=10.0.0
-Requires-Dist: pillow>=11.1.0
-Requires-Dist: psutil>=7.0.0
-Requires-Dist: pygetwindow>=0.0.9
-Requires-Dist: pyobjc-framework-quartz>=11.0
-Requires-Dist: requests>=2.32.3
-Requires-Dist: tree-sitter-c-sharp>=0.23.1
-Requires-Dist: tree-sitter-cpp>=0.23.4
-Requires-Dist: tree-sitter-go>=0.23.4
-Requires-Dist: tree-sitter-java>=0.23.5
-Requires-Dist: tree-sitter-javascript>=0.23.1
-Requires-Dist: tree-sitter-kotlin>=1.1.0
-Requires-Dist: tree-sitter-php>=0.23.11
-Requires-Dist: tree-sitter-python>=0.23.6
-Requires-Dist: tree-sitter-ruby>=0.23.1
-Requires-Dist: tree-sitter-rust==0.23.2
-Requires-Dist: tree-sitter-typescript>=0.23.2
-Requires-Dist: tree-sitter>=0.24.0
-Description-Content-Type: text/markdown
-
 # SkyDeckAI Code
 
-An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
+An MCP server that provides a comprehensive set of tools for AI-driven development workflows. Features include file system operations, code analysis using tree-sitter for multiple programming languages, Git operations, code execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks by providing direct access to both local and remote resources.
 
 # Formerly Known As MCP-Server-AIDD
 
@@ -45,28 +10,9 @@ This mcp server was formerly known as `mcp-server-aidd`. It was renamed to `skyd
 
 ## Installation
 
-### Installing via Smithery
-
-To install SkyDeckAI Code for Claude Desktop automatically via [Smithery](https://smithery.ai/server/skydeckai-code):
-
-```bash
-npx -y @smithery/cli install skydeckai-code --client claude
-```
-
-### Installing via McpGet
-
-```bash
-npx @michaellatman/mcp-get@latest install skydeckai-code
-```
-
-### Manual Installation
-
 ```bash
 # Using pip
 pip install skydeckai-code
-
-# Using uv
-uvx skydeckai-code
 ```
 
 ## Claude Desktop Setup
@@ -98,7 +44,8 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 -   Code content searching with regex pattern matching
 -   Multi-language code execution with safety measures
 -   Git operations (status, diff, commit, branch management, cloning)
--   Web content fetching from APIs and websites
+-   Web content fetching from APIs and websites with HTML-to-markdown conversion
+-   Multi-engine web search with reliable fallback mechanisms
 -   Batch operations for parallel and serial tool execution
 -   Security controls with configurable workspace boundaries
 -   Screenshot and screen context tools
@@ -571,6 +518,53 @@ skydeckai-code-cli --tool web_fetch --args '{
 }'
 ```
 
+#### web_search
+
+Performs a robust web search using multiple search engines and returns concise, relevant results.
+
+```json
+{
+    "query": "latest python release features",
+    "num_results": 8,
+    "convert_html_to_markdown": true,
+    "search_engine": "bing"
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| query | string | Yes | The search query to process. Be specific for better results. |
+| num_results | integer | No | Maximum number of search results to return (default: 10, max: 20) |
+| convert_html_to_markdown | boolean | No | When true, content will be converted from HTML to markdown for better readability (default: true) |
+| search_engine | string | No | Specifies which search engine to use: "auto" (default), "bing", or "duckduckgo" |
+
+**Returns:**
+A list of search results formatted in markdown, including titles, URLs, and snippets for each result. Results are deduplicated and organized hierarchically for easy reading.
+
+This tool uses a multi-engine approach that tries different search engines with various parsing strategies to ensure reliable results. You can specify a preferred engine, but some engines may block automated access, in which case the tool will fall back to alternative engines when "auto" is selected.
+
+**Example Usage:**
+
+```bash
+# Search with default settings (auto engine selection)
+skydeckai-code-cli --tool web_search --args '{
+    "query": "latest python release features"
+}'
+
+# Try DuckDuckGo if you want alternative results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "machine learning frameworks comparison",
+    "search_engine": "duckduckgo"
+}'
+
+# Use Bing for reliable results
+skydeckai-code-cli --tool web_search --args '{
+    "query": "best programming practices 2023",
+    "search_engine": "bing"
+}'
+```
+
 ### Utility Tools
 
 #### batch_tools

{skydeckai_code-0.1.27 → skydeckai_code-0.1.29}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "skydeckai-code"
-version = "0.1.27"
-description = "This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching, code content searching, and system information retrieval."
+version = "0.1.29"
+description = "This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, Git operations, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval."
 readme = "README.md"
 requires-python = ">=3.11"
 authors = [{name = "SkyDeck.ai", email = "support@skydeck.ai"}]
@@ -30,6 +30,7 @@ dependencies = [
     "pillow>=11.1.0",
     "requests>=2.32.3",
     "html2text>=2025.4.15",
+    "beautifulsoup4>=4.13.3",
 ]
 
 [tool.hatch.build.targets.wheel]

{skydeckai_code-0.1.27 → skydeckai_code-0.1.29}/src/aidd/tools/__init__.py

@@ -77,7 +77,7 @@ from .screenshot_tool import (
     handle_capture_screenshot,
 )
 from .system_tools import get_system_info_tool, handle_get_system_info
-from .web_tools import web_fetch_tool, handle_web_fetch
+from .web_tools import web_fetch_tool, handle_web_fetch, web_search_tool, handle_web_search
 
 # Export all tools definitions
 TOOL_DEFINITIONS = [
@@ -125,6 +125,7 @@ TOOL_DEFINITIONS = [
     read_image_file_tool(),
     # Web tools
     web_fetch_tool(),
+    web_search_tool(),
 ]
 
 # Export all handlers
@@ -173,4 +174,5 @@ TOOL_HANDLERS = {
     "read_image_file": handle_read_image_file,
     # Web handlers
     "web_fetch": handle_web_fetch,
+    "web_search": handle_web_search,
 }