skydeckai-code 0.1.23__tar.gz → 0.1.24__tar.gz

{skydeckai_code-0.1.23 → skydeckai_code-0.1.24}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: skydeckai-code
-Version: 0.1.23
-Summary: This MCP server provides a set of tools that support AI-driven Development workflows.
+Version: 0.1.24
+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
@@ -17,6 +17,7 @@ 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
@@ -33,7 +34,7 @@ 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, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks.
+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.
 
 # Formerly Known As MCP-Server-AIDD
 
@@ -90,11 +91,14 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 
 ## Key Features
 
--   File system operations (read, write, edit, move, delete)
+-   File system operations (read, write, edit, move, copy, delete)
 -   Directory management and traversal
 -   Multi-language code analysis using tree-sitter
+-   Code content searching with regex pattern matching
 -   Multi-language code execution with safety measures
--   Git operations (status, diff, commit, branch management)
+-   Git operations (status, diff, commit, branch management, cloning)
+-   Web content fetching from APIs and websites
+-   Batch operations for parallel and serial tool execution
 -   Security controls with configurable workspace boundaries
 -   Screenshot and screen context tools
 -   Image handling tools
@@ -103,24 +107,34 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 
 ### Basic File Operations
 
-| Tool                | Parameters                          | Returns                                       |
-| ------------------- | ----------------------------------- | --------------------------------------------- |
-| read_file           | path: string                        | File content                                  |
-| read_multiple_files | paths: string[]                     | Multiple file contents with headers           |
-| write_file          | path: string, content: string       | Success confirmation                          |
-| move_file           | source: string, destination: string | Success confirmation                          |
-| delete_file         | path: string                        | Success confirmation                          |
-| get_file_info       | path: string                        | File metadata (size, timestamps, permissions) |
+| Tool                | Parameters                                               | Returns                                       |
+| ------------------- | -------------------------------------------------------- | --------------------------------------------- |
+| read_file           | path: string, offset?: integer, limit?: integer          | File content (whole or partial)               |
+| read_multiple_files | paths: string[]                                          | Multiple file contents with headers           |
+| write_file          | path: string, content: string                            | Success confirmation                          |
+| move_file           | source: string, destination: string                      | Success confirmation                          |
+| copy_file           | source: string, destination: string, recursive?: boolean | Success confirmation                          |
+| delete_file         | path: string                                             | Success confirmation                          |
+| get_file_info       | path: string                                             | File metadata (size, timestamps, permissions) |
 
 Common usage:
 
 ```bash
-# Read file
+# Read entire file
 skydeckai-code-cli --tool read_file --args '{"path": "src/main.py"}'
 
+# Read 10 lines starting from line 20
+skydeckai-code-cli --tool read_file --args '{"path": "src/main.py", "offset": 20, "limit": 10}'
+
+# Read from line 50 to the end of the file
+skydeckai-code-cli --tool read_file --args '{"path": "src/main.py", "offset": 50}'
+
 # Write file
 skydeckai-code-cli --tool write_file --args '{"path": "output.txt", "content": "Hello World"}'
 
+# Copy file or directory
+skydeckai-code-cli --tool copy_file --args '{"source": "config.json", "destination": "config.backup.json"}'
+
 # Get file info
 skydeckai-code-cli --tool get_file_info --args '{"path": "src/main.py"}'
 ```
@@ -161,6 +175,8 @@ Returns: Diff of changes or preview in dry run mode.
 | create_directory         | path: string                                             | Success confirmation           |
 | search_files             | pattern: string, path?: string, include_hidden?: boolean | Matching files list            |
 
+The `search_files` tool searches for files by name pattern, while the `search_code` tool searches within file contents using regex. Use `search_files` when looking for files with specific names or extensions, and `search_code` when searching for specific text patterns inside files.
+
 #### directory_tree
 
 Generates complete directory structure:
@@ -186,17 +202,18 @@ skydeckai-code-cli --tool search_files --args '{"pattern": ".py", "path": "src"}
 
 ### Git Operations
 
-| Tool              | Parameters                             | Returns                          |
-| ----------------- | -------------------------------------- | -------------------------------- |
-| git_init          | path: string, initial_branch?: string  | Repository initialization status |
-| git_status        | repo_path: string                      | Working directory status         |
-| git_add           | repo_path: string, files: string[]     | Staging confirmation             |
-| git_reset         | repo_path: string                      | Unstaging confirmation           |
-| git_checkout      | repo_path: string, branch_name: string | Branch switch confirmation       |
-| git_create_branch | repo_path: string, branch_name: string | Branch creation confirmation     |
-| git_diff_unstaged | repo_path: string                      | Unstaged changes diff            |
-| git_diff_staged   | repo_path: string                      | Staged changes diff              |
-| git_show          | repo_path: string, commit_hash: string | Details of a specific commit     |
+| Tool              | Parameters                                        | Returns                          |
+| ----------------- | ------------------------------------------------- | -------------------------------- |
+| git_init          | path: string, initial_branch?: string             | Repository initialization status |
+| git_status        | repo_path: string                                 | Working directory status         |
+| git_add           | repo_path: string, files: string[]                | Staging confirmation             |
+| git_reset         | repo_path: string                                 | Unstaging confirmation           |
+| git_checkout      | repo_path: string, branch_name: string            | Branch switch confirmation       |
+| git_create_branch | repo_path: string, branch_name: string            | Branch creation confirmation     |
+| git_clone         | url: string, target_path: string, branch?: string | Clone confirmation               |
+| git_diff_unstaged | repo_path: string                                 | Unstaged changes diff            |
+| git_diff_staged   | repo_path: string                                 | Staged changes diff              |
+| git_show          | repo_path: string, commit_hash: string            | Details of a specific commit     |
 
 #### Complex Git Operations
 
@@ -239,6 +256,9 @@ Common usage:
 # Check status
 skydeckai-code-cli --tool git_status --args '{"repo_path": "."}'
 
+# Clone a repository
+skydeckai-code-cli --tool git_clone --args '{"url": "https://github.com/username/repo.git", "target_path": "repo"}'
+
 # Create and switch to new branch
 skydeckai-code-cli --tool git_create_branch --args '{"repo_path": ".", "branch_name": "feature/new-branch"}'
 ```
@@ -277,6 +297,59 @@ Supported Languages:
 -   C# (.cs)
 -   Kotlin (.kt, .kts)
 
+#### search_code
+
+Fast content search tool using regular expressions:
+
+```json
+{
+    "pattern": "function\\s+\\w+",
+    "include": "*.js",
+    "exclude": "node_modules/**",
+    "max_results": 50,
+    "case_sensitive": false,
+    "path": "src"
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| pattern | string | Yes | Regular expression pattern to search in file contents |
+| include | string | No | File pattern to include (glob syntax, default: "\*") |
+| exclude | string | No | File pattern to exclude (glob syntax, default: "") |
+| max_results | integer | No | Maximum results to return (default: 100) |
+| case_sensitive | boolean | No | Whether search is case-sensitive (default: false) |
+| path | string | No | Base directory to search from (default: ".") |
+
+**Returns:**
+Matching lines grouped by file with line numbers, sorted by file modification time with newest files first.
+
+This tool uses ripgrep when available for optimal performance, with a Python fallback implementation. It's ideal for finding specific code patterns like function declarations, imports, variable usages, or error handling.
+
+**Example Usage:**
+
+```bash
+# Find function declarations in JavaScript files
+skydeckai-code-cli --tool search_code --args '{
+    "pattern": "function\\s+\\w+",
+    "include": "*.js"
+}'
+
+# Find all console.log statements with errors
+skydeckai-code-cli --tool search_code --args '{
+    "pattern": "console\\.log.*[eE]rror",
+    "path": "src"
+}'
+
+# Find import statements in TypeScript files
+skydeckai-code-cli --tool search_code --args '{
+    "pattern": "import.*from",
+    "include": "*.{ts,tsx}",
+    "exclude": "node_modules/**"
+}'
+```
+
 ### System Information
 
 | Tool            | Parameters | Returns                      |
@@ -443,6 +516,181 @@ Base64-encoded image data that can be displayed or processed.
 
 This tool supports common image formats like PNG, JPEG, GIF, and WebP, and automatically resizes images for optimal viewing.
 
+### Web Tools
+
+#### web_fetch
+
+Fetches content from a URL and optionally saves it to a file.
+
+```json
+{
+    "url": "https://api.github.com/users/octocat",
+    "headers": {
+        "Accept": "application/json"
+    },
+    "timeout": 15,
+    "save_to_file": "downloads/octocat.json"
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| url | string | Yes | URL to fetch content from (http/https only) |
+| headers | object | No | Optional HTTP headers to include in the request |
+| timeout | integer | No | Maximum time to wait for response (default: 10s) |
+| save_to_file | string | No | Path to save response content (within allowed directory) |
+
+**Returns:**
+Response content as text with HTTP status code and size information. For binary content, returns metadata and saves to file if requested.
+
+This tool can be used to access web APIs, fetch documentation, or download content from the web while respecting size limits (10MB max) and security constraints.
+
+**Example Usage:**
+
+```bash
+# Fetch JSON from an API
+skydeckai-code-cli --tool web_fetch --args '{
+    "url": "https://api.github.com/users/octocat",
+    "headers": {"Accept": "application/json"}
+}'
+
+# Download content to a file
+skydeckai-code-cli --tool web_fetch --args '{
+    "url": "https://github.com/github/github-mcp-server/blob/main/README.md",
+    "save_to_file": "downloads/readme.md"
+}'
+```
+
+### Utility Tools
+
+#### batch_tools
+
+Execute multiple tool invocations in a single request with parallel execution when possible.
+
+```json
+{
+    "description": "Setup new project",
+    "sequential": true,
+    "invocations": [
+        {
+            "tool": "create_directory",
+            "arguments": {
+                "path": "src"
+            }
+        },
+        {
+            "tool": "write_file",
+            "arguments": {
+                "path": "README.md",
+                "content": "# New Project\n\nThis is a new project."
+            }
+        },
+        {
+            "tool": "git_init",
+            "arguments": {
+                "path": ".",
+                "initial_branch": "main"
+            }
+        }
+    ]
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| description | string | Yes | Short description of the batch operation |
+| sequential | boolean | No | Whether to run tools in sequence (default: false) |
+| invocations | array | Yes | List of tool invocations to execute |
+| invocations[].tool | string | Yes | Name of the tool to invoke |
+| invocations[].arguments | object | Yes | Arguments for the specified tool |
+
+**Returns:**
+Combined results from all tool invocations, grouped by tool with success/error status for each. Results are presented in the original invocation order with clear section headers.
+
+This tool provides efficient execution of multiple operations in a single request. When `sequential` is false (default), tools are executed in parallel for better performance. When `sequential` is true, tools are executed in order, and if any tool fails, execution stops.
+
+**IMPORTANT**: All tools in the batch execute in the same working directory context. If a tool creates a directory and a subsequent tool needs to work inside that directory, you must either:
+
+1. Use paths relative to the current working directory (e.g., "project/src" rather than just "src"), or
+2. Include an explicit tool invocation to change directories using `update_allowed_directory`
+
+**Example Usage:**
+
+```bash
+# Setup a new project with multiple steps in sequential order (using proper paths)
+skydeckai-code-cli --tool batch_tools --args '{
+    "description": "Setup new project",
+    "sequential": true,
+    "invocations": [
+        {"tool": "create_directory", "arguments": {"path": "project"}},
+        {"tool": "create_directory", "arguments": {"path": "project/src"}},
+        {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project\n\nA new project."}}
+    ]
+}'
+
+# Create nested structure using relative paths (without changing directory)
+skydeckai-code-cli --tool batch_tools --args '{
+    "description": "Create project structure",
+    "sequential": true,
+    "invocations": [
+        {"tool": "create_directory", "arguments": {"path": "project/src"}},
+        {"tool": "create_directory", "arguments": {"path": "project/docs"}},
+        {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project"}}
+    ]
+}'
+
+# Gather system information and take a screenshot (tasks can run in parallel)
+skydeckai-code-cli --tool batch_tools --args '{
+    "description": "System diagnostics",
+    "sequential": false,
+    "invocations": [
+        {"tool": "get_system_info", "arguments": {}},
+        {"tool": "capture_screenshot", "arguments": {
+            "output_path": "diagnostics/screen.png",
+            "capture_mode": {
+                "type": "full"
+            }
+        }}
+    ]
+}'
+```
+
+#### think
+
+A tool for complex reasoning and brainstorming without making changes to the repository.
+
+```json
+{
+    "thought": "Let me analyze the performance issue in the codebase:\n\n## Root Cause Analysis\n\n1. The database query is inefficient because:\n   - It doesn't use proper indexing\n   - It fetches more columns than needed\n   - The JOIN operation is unnecessarily complex\n\n## Potential Solutions\n\n1. **Add database indexes**:\n   - Create an index on the user_id column\n   - Create a composite index on (created_at, status)\n\n2. **Optimize the query**:\n   - Select only necessary columns\n   - Rewrite the JOIN using a subquery\n   - Add LIMIT clause for pagination\n\n3. **Add caching layer**:\n   - Cache frequent queries using Redis\n   - Implement cache invalidation strategy\n\nAfter weighing the options, solution #2 seems to be the simplest to implement with the highest impact."
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| thought | string | Yes | Your detailed thoughts, analysis or reasoning process |
+
+**Returns:**
+Your thoughts formatted as markdown, with a note indicating this was a thinking exercise.
+
+This tool is useful for thinking through complex problems, brainstorming solutions, or laying out implementation plans without making any actual changes. It's a great way to document your reasoning process, evaluate different approaches, or plan out a multi-step strategy before taking action.
+
+**Example Usage:**
+
+```bash
+# Analyze a bug and plan a fix
+skydeckai-code-cli --tool think --args '{
+    "thought": "# Bug Analysis\n\n## Observed Behavior\nThe login endpoint returns a 500 error when email contains Unicode characters.\n\n## Root Cause\nThe database adapter is not properly encoding Unicode strings before constructing the SQL query.\n\n## Potential Fixes\n1. Update the database adapter to use parameterized queries\n2. Add input validation to reject Unicode in emails\n3. Encode email input manually before database operations\n\nFix #1 is the best approach as it solves the core issue and improves security."
+}'
+
+# Evaluate design alternatives
+skydeckai-code-cli --tool think --args '{
+    "thought": "# API Design Options\n\n## REST vs GraphQL\nFor this use case, GraphQL would provide more flexible data fetching but adds complexity. REST is simpler and sufficient for our current needs.\n\n## Authentication Methods\nJWT-based authentication offers stateless operation and better scalability compared to session-based auth.\n\nRecommendation: Use REST with JWT authentication for the initial implementation."
+}'
+```
+
 ### Code Execution
 
 #### execute_code