skydeckai-code 0.1.23__py3-none-any.whl

skydeckai_code-0.1.23.dist-info/METADATA

@@ -0,0 +1,628 @@
+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.
+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: 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: 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, and system information retrieval. Designed to enhance AI's capability to assist in software development tasks.
+
+# Formerly Known As MCP-Server-AIDD
+
+This mcp server was formerly known as `mcp-server-aidd`. It was renamed to `skydeckai-code` to credit the team at [SkyDeck.ai](https://skydeck.ai) with creating this application along with [East Agile](https://eastagile.com). But more importantly we realized that the term AI Driven Development (AIDD) was just not catching on. People did not understand at a glance what it was about. And nor did LLMs. "Code" was far more intuitive. And linguistically intuitive is important in the world of agentic AI.
+
+<a href="https://glama.ai/mcp/servers/mpixtij6se"><img width="380" height="200" src="https://glama.ai/mcp/servers/mpixtij6se/badge" alt="AiDD Server MCP server" /></a>
+
+## 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
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+    "mcpServers": {
+        "skydeckai-code": {
+            "command": "uvx",
+            "args": ["skydeckai-code"]
+        }
+    }
+}
+```
+
+## SkyDeck AI Helper App
+
+If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and install it.
+
+![SkyDeck AI Helper App](/screenshots/skydeck_ai_helper.png)
+
+## Key Features
+
+-   File system operations (read, write, edit, move, delete)
+-   Directory management and traversal
+-   Multi-language code analysis using tree-sitter
+-   Multi-language code execution with safety measures
+-   Git operations (status, diff, commit, branch management)
+-   Security controls with configurable workspace boundaries
+-   Screenshot and screen context tools
+-   Image handling tools
+
+## Available Tools
+
+### 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) |
+
+Common usage:
+
+```bash
+# Read file
+skydeckai-code-cli --tool read_file --args '{"path": "src/main.py"}'
+
+# Write file
+skydeckai-code-cli --tool write_file --args '{"path": "output.txt", "content": "Hello World"}'
+
+# Get file info
+skydeckai-code-cli --tool get_file_info --args '{"path": "src/main.py"}'
+```
+
+### Complex File Operations
+
+#### edit_file
+
+Pattern-based file editing with preview support:
+
+```json
+{
+    "path": "src/main.py",
+    "edits": [
+        {
+            "oldText": "def old_function():",
+            "newText": "def new_function():"
+        }
+    ],
+    "dryRun": false,
+    "options": {
+        "preserveIndentation": true,
+        "normalizeWhitespace": true,
+        "partialMatch": true
+    }
+}
+```
+
+Returns: Diff of changes or preview in dry run mode.
+
+### Directory Operations
+
+| Tool                     | Parameters                                               | Returns                        |
+| ------------------------ | -------------------------------------------------------- | ------------------------------ |
+| get_allowed_directory    | none                                                     | Current allowed directory path |
+| update_allowed_directory | directory: string (absolute path)                        | Success confirmation           |
+| list_directory           | path: string                                             | Directory contents list        |
+| create_directory         | path: string                                             | Success confirmation           |
+| search_files             | pattern: string, path?: string, include_hidden?: boolean | Matching files list            |
+
+#### directory_tree
+
+Generates complete directory structure:
+
+```json
+{
+    "path": "src",
+    "include_hidden": false
+}
+```
+
+Returns: JSON tree structure of directory contents.
+
+Common usage:
+
+```bash
+# List directory
+skydeckai-code-cli --tool list_directory --args '{"path": "."}'
+
+# Search for Python files
+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     |
+
+#### Complex Git Operations
+
+##### git_commit
+
+```json
+{
+    "repo_path": ".",
+    "message": "feat: add new feature"
+}
+```
+
+Returns: Commit hash and confirmation.
+
+##### git_diff
+
+```json
+{
+    "repo_path": ".",
+    "target": "main"
+}
+```
+
+Returns: Detailed diff output showing all changes between the current branch and the specified target branch or commit.
+
+##### git_log
+
+```json
+{
+    "repo_path": ".",
+    "max_count": 10
+}
+```
+
+Returns: Array of commit entries with hash, author, date, and message.
+
+Common usage:
+
+```bash
+# Check status
+skydeckai-code-cli --tool git_status --args '{"repo_path": "."}'
+
+# Create and switch to new branch
+skydeckai-code-cli --tool git_create_branch --args '{"repo_path": ".", "branch_name": "feature/new-branch"}'
+```
+
+### Code Analysis
+
+#### codebase_mapper
+
+Analyzes source code structure:
+
+```json
+{
+    "path": "src"
+}
+```
+
+Returns:
+
+-   Classes and their methods
+-   Functions and parameters
+-   Module structure
+-   Code organization statistics
+-   Inheritance relationships
+
+Supported Languages:
+
+-   Python (.py)
+-   JavaScript (.js, .jsx, .mjs, .cjs)
+-   TypeScript (.ts, .tsx)
+-   Java (.java)
+-   C++ (.cpp, .hpp, .cc)
+-   Ruby (.rb, .rake)
+-   Go (.go)
+-   Rust (.rs)
+-   PHP (.php)
+-   C# (.cs)
+-   Kotlin (.kt, .kts)
+
+### System Information
+
+| Tool            | Parameters | Returns                      |
+| --------------- | ---------- | ---------------------------- |
+| get_system_info | none       | Comprehensive system details |
+
+Returns:
+
+```json
+{
+  "working_directory": "/path/to/project",
+  "system": {
+    "os", "os_version", "architecture", "python_version"
+  },
+  "wifi_network": "MyWiFi",
+  "cpu": {
+    "physical_cores", "logical_cores", "total_cpu_usage"
+  },
+  "memory": { "total", "available", "used_percentage" },
+  "disk": { "total", "free", "used_percentage" },
+  "mac_details": {  // Only present on macOS
+    "model": "Mac mini",
+    "chip": "Apple M2",
+    "serial_number": "XXX"
+  }
+}
+```
+
+Provides essential system information in a clean, readable format.
+
+```bash
+# Get system information
+skydeckai-code-cli --tool get_system_info
+```
+
+### Screen Context and Image Tools
+
+#### get_active_apps
+
+Returns a list of currently active applications on the user's system.
+
+```json
+{
+    "with_details": true
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| with_details | boolean | No | Whether to include additional details about each application (default: false) |
+
+**Returns:**
+
+```json
+{
+    "success": true,
+    "platform": "macos",
+    "app_count": 12,
+    "apps": [
+        {
+            "name": "Firefox",
+            "has_windows": true,
+            "window_count": 3,
+            "visible_windows": [
+                { "name": "GitHub - Mozilla Firefox", "width": 1200, "height": 800 }
+            ]
+        },
+        {
+            "name": "VSCode",
+            "has_windows": true
+        }
+    ]
+}
+```
+
+This tool provides valuable context about applications currently running on the user's system, which can help with providing more relevant assistance.
+
+#### get_available_windows
+
+Returns detailed information about all available windows currently displayed on the user's screen.
+
+```json
+{}
+```
+
+**Returns:**
+
+```json
+{
+    "success": true,
+    "platform": "macos",
+    "count": 8,
+    "windows": [
+        {
+            "id": 42,
+            "title": "Document.txt - Notepad",
+            "app": "Notepad",
+            "visible": true
+        },
+        {
+            "title": "Terminal",
+            "app": "Terminal",
+            "visible": true,
+            "active": true
+        }
+    ]
+}
+```
+
+This tool helps understand what's visible on the user's screen and can be used for context-aware assistance.
+
+#### capture_screenshot
+
+Captures a screenshot of the user's screen or a specific window.
+
+```json
+{
+    "output_path": "screenshots/capture.png",
+    "capture_mode": {
+        "type": "named_window",
+        "window_name": "Visual Studio Code"
+    }
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| output_path | string | No | Path where the screenshot should be saved (default: generated path) |
+| capture_mode | object | No | Specifies what to capture |
+| capture_mode.type | string | No | Type of screenshot: 'full', 'active_window', or 'named_window' (default: 'full') |
+| capture_mode.window_name | string | No | Name of window to capture (required when type is 'named_window') |
+
+**Returns:**
+
+```json
+{
+    "success": true,
+    "path": "/path/to/screenshots/capture.png"
+}
+```
+
+This tool captures screenshots for visualization, debugging, or context-aware assistance.
+
+#### read_image_file
+
+Reads an image file from the file system and returns its contents as a base64-encoded string.
+
+```json
+{
+    "path": "images/logo.png"
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| path | string | Yes | Path to the image file to read |
+| max_size | integer | No | Maximum file size in bytes (default: 100MB) |
+
+**Returns:**
+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.
+
+### Code Execution
+
+#### execute_code
+
+Executes code in various programming languages with safety measures and restrictions.
+
+```json
+{
+    "language": "python",
+    "code": "print('Hello, World!')",
+    "timeout": 5
+}
+```
+
+**Supported Languages:**
+
+-   Python (python3)
+-   JavaScript (Node.js)
+-   Ruby
+-   PHP
+-   Go
+-   Rust
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| language | string | Yes | Programming language to use |
+| code | string | Yes | Code to execute |
+| timeout | integer | No | Maximum execution time (default: 5s) |
+
+**Example Usage:**
+
+```bash
+# Python example
+skydeckai-code-cli --tool execute_code --args '{
+    "language": "python",
+    "code": "print(sum(range(10)))"
+}'
+
+# JavaScript example
+skydeckai-code-cli --tool execute_code --args '{
+    "language": "javascript",
+    "code": "console.log(Array.from({length: 5}, (_, i) => i*2))"
+}'
+
+# Ruby example
+skydeckai-code-cli --tool execute_code --args '{
+    "language": "ruby",
+    "code": "puts (1..5).reduce(:+)"
+}'
+
+# Go example
+skydeckai-code-cli --tool execute_code --args '{
+    "language": "go",
+    "code": "fmt.Println(\"Hello, Go!\")"
+}'
+```
+
+**Requirements:**
+
+-   Respective language runtimes must be installed
+-   Commands must be available in system PATH
+-   Proper permissions for temporary file creation
+
+⚠️ **Security Warning:**
+This tool executes arbitrary code on your system. Always:
+
+1. Review code thoroughly before execution
+2. Understand the code's purpose and expected outcome
+3. Never execute untrusted code
+4. Be aware of potential system impacts
+5. Monitor execution output
+
+#### execute_shell_script
+
+Executes shell scripts (bash/sh) with safety measures and restrictions.
+
+```json
+{
+    "script": "echo \"Current directory:\" && pwd",
+    "timeout": 300
+}
+```
+
+**Parameters:**
+| Parameter | Type | Required | Description |
+|-----------|---------|----------|---------------------------------------|
+| script | string | Yes | Shell script to execute |
+| timeout | integer | No | Maximum execution time (default: 300s, max: 600s) |
+
+**Example Usage:**
+
+```bash
+# List directory contents with details
+skydeckai-code-cli --tool execute_shell_script --args '{
+    "script": "ls -la"
+}'
+
+# Find all Python files recursively
+skydeckai-code-cli --tool execute_shell_script --args '{
+    "script": "find . -name \"*.py\" -type f"
+}'
+
+# Complex script with multiple commands
+skydeckai-code-cli --tool execute_shell_script --args '{
+    "script": "echo \"System Info:\" && uname -a && echo \"\nDisk Usage:\" && df -h"
+}'
+```
+
+**Features:**
+
+-   Uses /bin/sh for maximum compatibility across systems
+-   Executes within the allowed directory
+-   Separate stdout and stderr output
+-   Proper error handling and timeout controls
+
+⚠️ **Security Warning:**
+This tool executes arbitrary shell commands on your system. Always:
+
+1. Review the script thoroughly before execution
+2. Understand the script's purpose and expected outcome
+3. Never execute untrusted scripts
+4. Be aware of potential system impacts
+5. Monitor execution output
+
+## Configuration
+
+Configuration file: `~/.skydeckai_code/config.json`
+
+```json
+{
+    "allowed_directory": "/path/to/workspace"
+}
+```
+
+## CLI Usage
+
+Basic command structure:
+
+```bash
+skydeckai-code-cli --tool <tool_name> --args '<json_arguments>'
+
+# List available tools
+skydeckai-code-cli --list-tools
+
+# Enable debug output
+skydeckai-code-cli --debug --tool <tool_name> --args '<json_arguments>'
+```
+
+## Debugging
+
+Use MCP Inspector for debugging:
+
+```bash
+npx @modelcontextprotocol/inspector run
+```
+
+## Security
+
+-   Operations restricted to configured allowed directory
+-   Path traversal prevention
+-   File permission preservation
+-   Safe operation handling
+
+## Upcoming Features
+
+-   GitHub tools:
+    -   PR Description Generator
+    -   Code Review
+    -   Actions Manager
+-   Pivotal Tracker tools:
+    -   Story Generator
+    -   Story Manager
+
+## Development Status
+
+Currently in active development. Features and API may change.
+
+## License
+
+Apache License 2.0 - see [LICENSE](LICENSE)
+
+[![Star History Chart](https://api.star-history.com/svg?repos=skydeckai/skydeckai-code&type=Date)](https://www.star-history.com/#skydeckai/skydeckai-code&Date)

skydeckai_code-0.1.23.dist-info/RECORD

@@ -0,0 +1,22 @@
+aidd/__init__.py,sha256=c9HBWxWruCxoAqLCJqltylAwz_7xmaK3g8DKViJZs0Q,222
+aidd/cli.py,sha256=cLtaQJmMBfr7fHkd0dyJqpDrVTIwybL48PotniWGrFM,5031
+aidd/server.py,sha256=kPRyWeWkMCZjabelC65XTmzZG7yw8htMJKSfnUcKnb0,1575
+aidd/tools/__init__.py,sha256=Ey6Kvj1_riwKwnS6PN2152QM_qLExZJj4pXtYMiYcS0,4548
+aidd/tools/base.py,sha256=wHSAaGGYWM8ECmoYd7KEcmjsZRWesNQFf3zMjCKGMcc,380
+aidd/tools/code_analysis.py,sha256=fDpm2o_If5PsngXzHN2-ezSkPVT0ZxivLuzmHrOAmVU,33188
+aidd/tools/code_execution.py,sha256=dIPxHBtclsetDZY4jGlSBrw_t-7VlIVrK8mflnZ6c4w,13176
+aidd/tools/directory_tools.py,sha256=Hxzge_ziYw_FsjYb5yF0R0dHEdvuWRsg7WsdYDG0AUg,12971
+aidd/tools/file_tools.py,sha256=DP58WQCkNEcWsu4n1MNWLS3ki6CLX9Q4tW_Jy4XzPiw,36995
+aidd/tools/get_active_apps_tool.py,sha256=BjLF7iXSDgyAmm_gfFgAul2Gn3iX-CNVYHM7Sh4jTAI,19427
+aidd/tools/get_available_windows_tool.py,sha256=OVIYhItTn9u_DftOr3vPCT-R0DOFvMEEJXA6tD6gqWQ,15952
+aidd/tools/git_tools.py,sha256=gpjme4REvDYuVhn2iDcgwYvp6C0MnP36NWB6HgCA1YQ,35401
+aidd/tools/image_tools.py,sha256=wT3EcJAfZWcM0IsXdDfbTNjgFhKZM9nu2wHN6Mk_TTQ,5970
+aidd/tools/path_tools.py,sha256=RGoOhqP69eHJzM8tEgn_5-GRaR0gp25fd0XZIJ_RnQE,4045
+aidd/tools/screenshot_tool.py,sha256=peifNcpyDPtodubs7XyzheoUyK2h_e3qXsdM57bEB5U,45906
+aidd/tools/state.py,sha256=RWSw0Jfsui8FqC0xsI7Ik07tAg35hRwLHa5xGBVbiI4,1493
+aidd/tools/system_tools.py,sha256=H4_qveKC2HA7SIbi-j4vxA0W4jYh2wfu9A6ni5wkZyA,7249
+skydeckai_code-0.1.23.dist-info/METADATA,sha256=DpYWSa8FMSBNJDNpI6YTYOgbuM-Xe9Obw2WSkKjzfzE,17406
+skydeckai_code-0.1.23.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+skydeckai_code-0.1.23.dist-info/entry_points.txt,sha256=cT-IHh3_ioGLk3kwIeqj1X6Li1dnJinX9qKWUl7nOLg,80
+skydeckai_code-0.1.23.dist-info/licenses/LICENSE,sha256=uHse04vmI6ZjW7TblegFl30X-sDyyF0-QvH8ItPca3c,10865
+skydeckai_code-0.1.23.dist-info/RECORD,,

skydeckai_code-0.1.23.dist-info/WHEEL

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

skydeckai_code-0.1.23.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+skydeckai-code = aidd:main
+skydeckai-code-cli = aidd.cli:main