skydeckai-code 0.1.38__tar.gz → 0.1.40__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/PKG-INFO +6 -246
  2. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/README.md +5 -245
  3. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/pyproject.toml +1 -1
  4. skydeckai_code-0.1.40/screenshots/mseep_ai_helper.png +0 -0
  5. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/code_execution.py +135 -98
  6. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/code_tools.py +53 -7
  7. skydeckai_code-0.1.40/src/aidd/tools/directory_tools.py +434 -0
  8. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/file_tools.py +90 -21
  9. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/system_tools.py +4 -1
  10. skydeckai_code-0.1.38/screenshots/skydeck_ai_helper.png +0 -0
  11. skydeckai_code-0.1.38/src/aidd/tools/directory_tools.py +0 -289
  12. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/.claude/settings.local.json +0 -0
  13. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/.gitignore +0 -0
  14. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/Dockerfile +0 -0
  15. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/LICENSE +0 -0
  16. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/smithery.yaml +0 -0
  17. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/__init__.py +0 -0
  18. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/__init__.py +0 -0
  19. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/cli.py +0 -0
  20. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/server.py +0 -0
  21. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/__init__.py +0 -0
  22. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/base.py +0 -0
  23. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/code_analysis.py +0 -0
  24. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/get_active_apps_tool.py +0 -0
  25. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/get_available_windows_tool.py +0 -0
  26. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/image_tools.py +0 -0
  27. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/other_tools.py +0 -0
  28. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/path_tools.py +0 -0
  29. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/screenshot_tool.py +0 -0
  30. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/state.py +0 -0
  31. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/src/aidd/tools/web_tools.py +0 -0
  32. {skydeckai_code-0.1.38 → skydeckai_code-0.1.40}/uv.lock +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: skydeckai-code
3
- Version: 0.1.38
3
+ Version: 0.1.40
4
4
  Summary: This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval.
5
5
  Project-URL: Homepage, https://github.com/skydeckai/skydeckai-code
6
6
  Project-URL: Repository, https://github.com/skydeckai/skydeckai-code
@@ -43,13 +43,13 @@ An MCP server that provides a comprehensive set of tools for AI-driven developme
43
43
 
44
44
  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.
45
45
 
46
- <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>
46
+ [![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/fe7a40fd-30c1-4767-84f9-d33bf997497e)
47
47
 
48
48
  ## Installation
49
49
 
50
50
  ```bash
51
- # Using pip
52
- pip install skydeckai-code
51
+ # Using uvx
52
+ uvx skydeckai-code
53
53
  ```
54
54
 
55
55
  ## Claude Desktop Setup
@@ -69,9 +69,9 @@ Add to your `claude_desktop_config.json`:
69
69
 
70
70
  ## SkyDeck AI Helper App
71
71
 
72
- If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and install it.
72
+ If you're using MseeP AI Helper app, you can search for "SkyDeckAI Code" and install it.
73
73
 
74
- ![SkyDeck AI Helper App](/screenshots/skydeck_ai_helper.png)
74
+ ![MseeP AI Helper App](/screenshots/mseep_ai_helper.png)
75
75
 
76
76
  ## Key Features
77
77
 
@@ -131,34 +131,6 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
131
131
  | delete_file | path: string | Success confirmation |
132
132
  | get_file_info | path: string | File metadata (size, timestamps, permissions) |
133
133
 
134
- **CLI Usage:**
135
-
136
- ```bash
137
- # Read entire file
138
- skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py"}]}'
139
-
140
- # Read 10 lines starting from line 20
141
- skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 20, "limit": 10}]}'
142
-
143
- # Read from line 50 to the end of the file
144
- skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 50}]}'
145
-
146
- # Read multiple files with different line ranges
147
- skydeckai-code-cli --tool read_file --args '{"files": [
148
- {"path": "src/main.py", "offset": 1, "limit": 10},
149
- {"path": "README.md"}
150
- ]}'
151
-
152
- # Write file
153
- skydeckai-code-cli --tool write_file --args '{"path": "output.txt", "content": "Hello World"}'
154
-
155
- # Copy file or directory
156
- skydeckai-code-cli --tool copy_file --args '{"source": "config.json", "destination": "config.backup.json"}'
157
-
158
- # Get file info
159
- skydeckai-code-cli --tool get_file_info --args '{"path": "src/main.py"}'
160
- ```
161
-
162
134
  ### Complex File Operations
163
135
 
164
136
  #### edit_file
@@ -208,16 +180,6 @@ Generates complete directory structure:
208
180
 
209
181
  Returns: JSON tree structure of directory contents.
210
182
 
211
- **CLI Usage:**
212
-
213
- ```bash
214
- # List directory
215
- skydeckai-code-cli --tool list_directory --args '{"path": "."}'
216
-
217
- # Search for Python files
218
- skydeckai-code-cli --tool search_files --args '{"pattern": ".py", "path": "src"}'
219
- ```
220
-
221
183
  ### Code Analysis
222
184
 
223
185
  #### codebase_mapper
@@ -252,19 +214,6 @@ Supported Languages:
252
214
  - C# (.cs)
253
215
  - Kotlin (.kt, .kts)
254
216
 
255
- **CLI Usage:**
256
-
257
- ```bash
258
- # Map the entire codebase structure
259
- skydeckai-code-cli --tool codebase_mapper --args '{"path": "."}'
260
-
261
- # Map only the source directory
262
- skydeckai-code-cli --tool codebase_mapper --args '{"path": "src"}'
263
-
264
- # Map a specific component or module
265
- skydeckai-code-cli --tool codebase_mapper --args '{"path": "src/components"}'
266
- ```
267
-
268
217
  #### search_code
269
218
 
270
219
  Fast content search tool using regular expressions:
@@ -295,29 +244,6 @@ Matching lines grouped by file with line numbers, sorted by file modification ti
295
244
 
296
245
  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.
297
246
 
298
- **CLI Usage:**
299
-
300
- ```bash
301
- # Find function and class declarations in JavaScript files
302
- skydeckai-code-cli --tool search_code --args '{
303
- "patterns": ["function\\s+\\w+", "class\\s+\\w+"],
304
- "include": "*.js"
305
- }'
306
-
307
- # Find all console.log statements with errors or warnings
308
- skydeckai-code-cli --tool search_code --args '{
309
- "patterns": ["console\\.log.*[eE]rror", "console\\.log.*[wW]arning"],
310
- "path": "src"
311
- }'
312
-
313
- # Find import and export statements in TypeScript files
314
- skydeckai-code-cli --tool search_code --args '{
315
- "patterns": ["import.*from", "export.*"],
316
- "include": "*.{ts,tsx}",
317
- "exclude": "node_modules/**"
318
- }'
319
- ```
320
-
321
247
  ### System Information
322
248
 
323
249
  | Tool | Parameters | Returns |
@@ -348,13 +274,6 @@ Returns:
348
274
 
349
275
  Provides essential system information in a clean, readable format.
350
276
 
351
- **CLI Usage:**
352
-
353
- ```bash
354
- # Get system information
355
- skydeckai-code-cli --tool get_system_info
356
- ```
357
-
358
277
  ### Screen Context and Image Tools
359
278
 
360
279
  #### get_active_apps
@@ -518,28 +437,6 @@ Response content as text with HTTP status code and size information. For binary
518
437
 
519
438
  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.
520
439
 
521
- **CLI Usage:**
522
-
523
- ```bash
524
- # Fetch JSON from an API
525
- skydeckai-code-cli --tool web_fetch --args '{
526
- "url": "https://api.github.com/users/octocat",
527
- "headers": {"Accept": "application/json"}
528
- }'
529
-
530
- # Download content to a file
531
- skydeckai-code-cli --tool web_fetch --args '{
532
- "url": "https://github.com/github/github-mcp-server/blob/main/README.md",
533
- "save_to_file": "downloads/readme.md"
534
- }'
535
-
536
- # Fetch a webpage and convert to markdown for better readability
537
- skydeckai-code-cli --tool web_fetch --args '{
538
- "url": "https://example.com",
539
- "convert_html_to_markdown": true
540
- }'
541
- ```
542
-
543
440
  #### web_search
544
441
 
545
442
  Performs a robust web search using multiple search engines and returns concise, relevant results.
@@ -566,27 +463,6 @@ A list of search results formatted in markdown, including titles, URLs, and snip
566
463
 
567
464
  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.
568
465
 
569
- **CLI Usage:**
570
-
571
- ```bash
572
- # Search with default settings (auto engine selection)
573
- skydeckai-code-cli --tool web_search --args '{
574
- "query": "latest python release features"
575
- }'
576
-
577
- # Try DuckDuckGo if you want alternative results
578
- skydeckai-code-cli --tool web_search --args '{
579
- "query": "machine learning frameworks comparison",
580
- "search_engine": "duckduckgo"
581
- }'
582
-
583
- # Use Bing for reliable results
584
- skydeckai-code-cli --tool web_search --args '{
585
- "query": "best programming practices 2023",
586
- "search_engine": "bing"
587
- }'
588
- ```
589
-
590
466
  ### Utility Tools
591
467
 
592
468
  #### batch_tools
@@ -640,47 +516,6 @@ This tool provides efficient execution of multiple operations in a single reques
640
516
  1. Use paths relative to the current working directory (e.g., "project/src" rather than just "src"), or
641
517
  2. Include an explicit tool invocation to change directories using `update_allowed_directory`
642
518
 
643
- **CLI Usage:**
644
-
645
- ```bash
646
- # Setup a new project with multiple steps in sequential order (using proper paths)
647
- skydeckai-code-cli --tool batch_tools --args '{
648
- "description": "Setup new project",
649
- "sequential": true,
650
- "invocations": [
651
- {"tool": "create_directory", "arguments": {"path": "project"}},
652
- {"tool": "create_directory", "arguments": {"path": "project/src"}},
653
- {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project\n\nA new project."}}
654
- ]
655
- }'
656
-
657
- # Create nested structure using relative paths (without changing directory)
658
- skydeckai-code-cli --tool batch_tools --args '{
659
- "description": "Create project structure",
660
- "sequential": true,
661
- "invocations": [
662
- {"tool": "create_directory", "arguments": {"path": "project/src"}},
663
- {"tool": "create_directory", "arguments": {"path": "project/docs"}},
664
- {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project"}}
665
- ]
666
- }'
667
-
668
- # Gather system information and take a screenshot (tasks can run in parallel)
669
- skydeckai-code-cli --tool batch_tools --args '{
670
- "description": "System diagnostics",
671
- "sequential": false,
672
- "invocations": [
673
- {"tool": "get_system_info", "arguments": {}},
674
- {"tool": "capture_screenshot", "arguments": {
675
- "output_path": "diagnostics/screen.png",
676
- "capture_mode": {
677
- "type": "full"
678
- }
679
- }}
680
- ]
681
- }'
682
- ```
683
-
684
519
  #### think
685
520
 
686
521
  A tool for complex reasoning and brainstorming without making changes to the repository.
@@ -701,20 +536,6 @@ Your thoughts formatted as markdown, with a note indicating this was a thinking
701
536
 
702
537
  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.
703
538
 
704
- **CLI Usage:**
705
-
706
- ```bash
707
- # Analyze a bug and plan a fix
708
- skydeckai-code-cli --tool think --args '{
709
- "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."
710
- }'
711
-
712
- # Evaluate design alternatives
713
- skydeckai-code-cli --tool think --args '{
714
- "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."
715
- }'
716
- ```
717
-
718
539
  ### Code Execution
719
540
 
720
541
  #### execute_code
@@ -745,34 +566,6 @@ Executes code in various programming languages with safety measures and restrict
745
566
  | code | string | Yes | Code to execute |
746
567
  | timeout | integer | No | Maximum execution time (default: 5s) |
747
568
 
748
- **CLI Usage:**
749
-
750
- ```bash
751
- # Python example
752
- skydeckai-code-cli --tool execute_code --args '{
753
- "language": "python",
754
- "code": "print(sum(range(10)))"
755
- }'
756
-
757
- # JavaScript example
758
- skydeckai-code-cli --tool execute_code --args '{
759
- "language": "javascript",
760
- "code": "console.log(Array.from({length: 5}, (_, i) => i*2))"
761
- }'
762
-
763
- # Ruby example
764
- skydeckai-code-cli --tool execute_code --args '{
765
- "language": "ruby",
766
- "code": "puts (1..5).reduce(:+)"
767
- }'
768
-
769
- # Go example
770
- skydeckai-code-cli --tool execute_code --args '{
771
- "language": "go",
772
- "code": "fmt.Println(\"Hello, Go!\")"
773
- }'
774
- ```
775
-
776
569
  **Requirements:**
777
570
 
778
571
  - Respective language runtimes must be installed
@@ -805,25 +598,6 @@ Executes shell scripts (bash/sh) with safety measures and restrictions.
805
598
  | script | string | Yes | Shell script to execute |
806
599
  | timeout | integer | No | Maximum execution time (default: 300s, max: 600s) |
807
600
 
808
- **CLI Usage:**
809
-
810
- ```bash
811
- # List directory contents with details
812
- skydeckai-code-cli --tool execute_shell_script --args '{
813
- "script": "ls -la"
814
- }'
815
-
816
- # Find all Python files recursively
817
- skydeckai-code-cli --tool execute_shell_script --args '{
818
- "script": "find . -name \"*.py\" -type f"
819
- }'
820
-
821
- # Complex script with multiple commands
822
- skydeckai-code-cli --tool execute_shell_script --args '{
823
- "script": "echo \"System Info:\" && uname -a && echo \"\nDisk Usage:\" && df -h"
824
- }'
825
- ```
826
-
827
601
  **Features:**
828
602
 
829
603
  - Uses /bin/sh for maximum compatibility across systems
@@ -850,20 +624,6 @@ Configuration file: `~/.skydeckai_code/config.json`
850
624
  }
851
625
  ```
852
626
 
853
- ## CLI Usage
854
-
855
- Basic command structure:
856
-
857
- ```bash
858
- skydeckai-code-cli --tool <tool_name> --args '<json_arguments>'
859
-
860
- # List available tools
861
- skydeckai-code-cli --list-tools
862
-
863
- # Enable debug output
864
- skydeckai-code-cli --debug --tool <tool_name> --args '<json_arguments>'
865
- ```
866
-
867
627
  ## Debugging
868
628
 
869
629
  Use MCP Inspector for debugging: