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, 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.

This mcp server was formerly known asmcp-server-aidd. It was renamed toskydeckai-codeto credit the team atSkyDeck.aiwith creating this application along withEast Agile. 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.

{ "mcpServers": { "skydeckai-code": { "command": "uvx", "args": ["skydeckai-code"] } } }

If you're using MseeP AI Helper app, you can search for "SkyDeckAI Code" and install it.

- 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
- 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
- Image handling tools

Pattern-based file editing with preview support:

{ "path": "src/main.py", "edits": [ { "oldText": "def old_function():", "newText": "def new_function():" } ], "dryRun": false, "options": { "partialMatch": true } }

Returns: Diff of changes or preview in dry run mode.

Thesearch_filestool searches for files by name pattern, while thesearch_codetool searches within file contents using regex. Usesearch_fileswhen looking for files with specific names or extensions, andsearch_codewhen searching for specific text patterns inside files.

{ "path": "src", "include_hidden": false }

Returns: JSON tree structure of directory contents.

- Classes and their methods
- Functions and parameters
- Module structure
- Code organization statistics
- Inheritance relationships

- 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)

Fast content search tool using regular expressions:

{ "patterns": ["function\\s+\\w+", "class\\s+\\w+"], "include": ".js", "exclude": "node_modules/", "max_results": 50, "case_sensitive": false, "path": "src" }

{ "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" } }

{ "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 } ] }

{ "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 } ] }

{ "output_path": "screenshots/capture.png", "capture_mode": { "type": "named_window", "window_name": "Visual Studio Code" } }

{ "success": true, "path": "/path/to/screenshots/capture.png" }

{ "path": "images/logo.png" }

{ "url": "https://api.github.com/users/octocat", "headers": { "Accept": "application/json" }, "timeout": 15, "save_to_file": "downloads/octocat.json", "convert_html_to_markdown": true }

{ "query": "latest python release features", "num_results": 8, "convert_html_to_markdown": true, "search_engine": "bing" }

{ "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": "execute_shell_script", "arguments": { "script": "git init" } } ] }

{ "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." }

{ "language": "python", "code": "print('Hello, World!')", "timeout": 5 }

{ "script": "echo \"Current directory:\" && pwd", "timeout": 300 }

⚠️Security Warning:*This tool executes arbitrary shell commands on your system. Always:
- Review the script thoroughly before execution
- Understand the script's purpose and expected outcome
- Never execute untrusted scripts
- Be aware of potential system impacts
- Monitor execution output

The todo tools provide sequential task management capabilities for workspace-first development workflows. Tasks are executed in order without priority systems, ensuring structured progress through development phases.

Read the current todo list for the workspace.

{ "todos": [ { "id": "abc123", "content": "Implement user authentication", "status": "in_progress", "metadata": { "custom_key": "custom_value" }, "created_at": "2023-10-01T10:00:00Z", "updated_at": "2023-10-01T11:30:00Z" } ], "count": 1, "workspace": "/path/to/workspace" }

Replace the entire todo list for sequential execution workflow. Tasks are executed in array order, building upon previous work.

{ "todos": [ { "id": "task1", "content": "Set up database schema", "status": "pending" }, { "id": "task2", "content": "Create API endpoints", "status": "pending", "metadata": { "custom_key": "custom_value" } } ] }

- Each todo must have unique ID
- Only one task can be "in_progress" at a time (sequential execution)
- Tasks execute in array order - no priority system
- Required fields: id, content, status
- Status values: "pending", "in_progress", "completed"
- Workspace-first: Todo management is mandatory for all workspace operations

Update a specific todo item by ID for sequential workflow progression.

{ "todo_id": "task1", "updates": { "status": "in_progress", "metadata": { "new_key": "new_value" } } }

{ "success": true, "updated_todo": { "id": "task1", "content": "Set up database schema", "status": "in_progress", "updated_at": "2023-10-01T12:00:00Z", "metadata": { "new_key": "new_value" } }, "counts": { "pending": 1, "in_progress": 1, "completed": 0, "total": 2 }, "workspace": "/path/to/workspace" }

The todo system maintains separate sequential task lists for each workspace, enforcing mandatory usage for all workspace operations. Tasks execute in order, building upon previous work without priority-based scheduling.

Configuration file:~/.skydeckai_code/config.json

{ "allowed_directory": "/path/to/workspace" }

- Operations restricted to configured allowed directory
- Path traversal prevention
- File permission preservation
- Safe operation handling

- GitHub tools:

- PR Description Generator
- Code Review
- Actions Manager

Currently in active development. Features and API may change.

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.