AiDD MCP Server

by skydeckai

Integrations

  • Supports code analysis using tree-sitter for C++ files (.cpp, .hpp, .cc)

  • Provides Git operations including repository initialization, status checking, adding files, resetting, checkout, commit, diff, and log viewing

  • Upcoming features include GitHub tools such as PR Description Generator, Code Review, and Actions Manager

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.

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 with creating this application along with East 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.

Installation

# Using pip pip install skydeckai-code

Claude Desktop Setup

Add to your claude_desktop_config.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.

Key Features

  • 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

Available Tools (26)

CategoryTool NameDescription
File Systemget_allowed_directoryGet the current working directory path
update_allowed_directoryChange the working directory
create_directoryCreate a new directory or nested directories
write_fileCreate or overwrite a file with new content
edit_fileMake line-based edits to a text file
read_fileRead the contents of one or more files
list_directoryGet listing of files and directories
move_fileMove or rename a file or directory
copy_fileCopy a file or directory to a new location
search_filesSearch for files matching a name pattern
delete_fileDelete a file or empty directory
get_file_infoGet detailed file metadata
directory_treeGet a recursive tree view of directories
read_image_fileRead an image file as base64 data
Code Toolscodebase_mapperAnalyze code structure across files
search_codeFind text patterns in code files
execute_codeRun code in various languages
execute_shell_scriptRun shell/bash scripts
Web Toolsweb_fetchGet content from a URL
web_searchPerform a web search
Screen Toolscapture_screenshotTake a screenshot of screen or window
get_active_appsList running applications
get_available_windowsList all open windows
Systemget_system_infoGet detailed system information
Utilitybatch_toolsRun multiple tool operations together
thinkDocument reasoning without making changes

Detailed Tool Documentation

Basic File Operations

ToolParametersReturns
read_filefiles: [{path: string, offset?: integer, limit?: integer}]File content (single or multiple files)
write_filepath: string, content: stringSuccess confirmation
move_filesource: string, destination: stringSuccess confirmation
copy_filesource: string, destination: string, recursive?: booleanSuccess confirmation
delete_filepath: stringSuccess confirmation
get_file_infopath: stringFile metadata (size, timestamps, permissions)

CLI Usage:

# Read entire file skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py"}]}' # Read 10 lines starting from line 20 skydeckai-code-cli --tool read_file --args '{"files": [{"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 '{"files": [{"path": "src/main.py", "offset": 50}]}' # Read multiple files with different line ranges skydeckai-code-cli --tool read_file --args '{"files": [ {"path": "src/main.py", "offset": 1, "limit": 10}, {"path": "README.md"} ]}' # 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"}'

Complex File Operations

edit_file

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.

Directory Operations

ToolParametersReturns
get_allowed_directorynoneCurrent allowed directory path
update_allowed_directorydirectory: string (absolute path)Success confirmation
list_directorypath: stringDirectory contents list
create_directorypath: stringSuccess confirmation
search_filespattern: string, path?: string, include_hidden?: booleanMatching 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:

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

Returns: JSON tree structure of directory contents.

CLI Usage:

# 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"}'

Code Analysis

codebase_mapper

Analyzes source code structure:

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

CLI Usage:

# Map the entire codebase structure skydeckai-code-cli --tool codebase_mapper --args '{"path": "."}' # Map only the source directory skydeckai-code-cli --tool codebase_mapper --args '{"path": "src"}' # Map a specific component or module skydeckai-code-cli --tool codebase_mapper --args '{"path": "src/components"}'
search_code

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

Parameters:

ParameterTypeRequiredDescription
patternsarray of stringsYesList of regular expression patterns to search for in file contents
includestringNoFile pattern to include (glob syntax, default: "*")
excludestringNoFile pattern to exclude (glob syntax, default: "")
max_resultsintegerNoMaximum results to return per pattern (default: 100)
case_sensitivebooleanNoWhether search is case-sensitive (default: false)
pathstringNoBase 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.

CLI Usage:

# Find function and class declarations in JavaScript files skydeckai-code-cli --tool search_code --args '{ "patterns": ["function\\s+\\w+", "class\\s+\\w+"], "include": "*.js" }' # Find all console.log statements with errors or warnings skydeckai-code-cli --tool search_code --args '{ "patterns": ["console\\.log.*[eE]rror", "console\\.log.*[wW]arning"], "path": "src" }' # Find import and export statements in TypeScript files skydeckai-code-cli --tool search_code --args '{ "patterns": ["import.*from", "export.*"], "include": "*.{ts,tsx}", "exclude": "node_modules/**" }'

System Information

ToolParametersReturns
get_system_infononeComprehensive system details

Returns:

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

CLI Usage:

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

{ "with_details": true }

Parameters:

ParameterTypeRequiredDescription
with_detailsbooleanNoWhether to include additional details about each application (default: false)

Returns:

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

{}

Returns:

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

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

Parameters:

ParameterTypeRequiredDescription
output_pathstringNoPath where the screenshot should be saved (default: generated path)
capture_modeobjectNoSpecifies what to capture
capture_mode.typestringNoType of screenshot: 'full', 'active_window', or 'named_window' (default: 'full')
capture_mode.window_namestringNoName of window to capture (required when type is 'named_window')

Returns:

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

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

Parameters:

ParameterTypeRequiredDescription
pathstringYesPath to the image file to read
max_sizeintegerNoMaximum 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.

Web Tools

web_fetch

Fetches content from a URL and optionally saves it to a file.

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

Parameters:

ParameterTypeRequiredDescription
urlstringYesURL to fetch content from (http/https only)
headersobjectNoOptional HTTP headers to include in the request
timeoutintegerNoMaximum time to wait for response (default: 10s)
save_to_filestringNoPath to save response content (within allowed directory)
convert_html_to_markdownbooleanNoWhen true, converts HTML content to markdown for better readability (default: true)

Returns: Response content as text with HTTP status code and size information. For binary content, returns metadata and saves to file if requested. When convert_html_to_markdown is enabled, HTML content is automatically converted to markdown format for better readability.

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.

CLI Usage:

# 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" }' # Fetch a webpage and convert to markdown for better readability skydeckai-code-cli --tool web_fetch --args '{ "url": "https://example.com", "convert_html_to_markdown": true }'

Performs a robust web search using multiple search engines and returns concise, relevant results.

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

Parameters:

ParameterTypeRequiredDescription
querystringYesThe search query to process. Be specific for better results.
num_resultsintegerNoMaximum number of search results to return (default: 10, max: 20)
convert_html_to_markdownbooleanNoWhen true, content will be converted from HTML to markdown for better readability (default: true)
search_enginestringNoSpecifies 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.

CLI Usage:

# 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

Execute multiple tool invocations in a single request with parallel execution when possible.

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

Parameters:

ParameterTypeRequiredDescription
descriptionstringYesShort description of the batch operation
sequentialbooleanNoWhether to run tools in sequence (default: false)
invocationsarrayYesList of tool invocations to execute
invocations[].toolstringYesName of the tool to invoke
invocations[].argumentsobjectYesArguments 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

CLI Usage:

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

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

ParameterTypeRequiredDescription
thoughtstringYesYour 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.

CLI Usage:

# 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

Executes code in various programming languages with safety measures and restrictions.

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

Supported Languages:

  • Python (python3)
  • JavaScript (Node.js)
  • Ruby
  • PHP
  • Go
  • Rust

Parameters:

ParameterTypeRequiredDescription
languagestringYesProgramming language to use
codestringYesCode to execute
timeoutintegerNoMaximum execution time (default: 5s)

CLI Usage:

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

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

Parameters:

ParameterTypeRequiredDescription
scriptstringYesShell script to execute
timeoutintegerNoMaximum execution time (default: 300s, max: 600s)

CLI Usage:

# 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

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

CLI Usage

Basic command structure:

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:

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

AiDD MCP Server provides a secure interface for AI agents to perform file system operations and code analysis, enhancing AI-assisted development workflows across multiple programming languages.

  1. Formerly Known As MCP-Server-AIDD
    1. Installation
    2. Claude Desktop Setup
    3. SkyDeck AI Helper App
    4. Key Features
    5. Available Tools (26)
    6. Detailed Tool Documentation
    7. Configuration
    8. CLI Usage
    9. Debugging
    10. Security
    11. Upcoming Features
    12. Development Status
    13. License

Related MCP Servers

  • -
    security
    A
    license
    -
    quality
    An MCP server that implements Claude Code-like functionality, allowing the AI to analyze codebases, modify files, execute commands, and manage projects through direct file system interactions.
    Last updated -
    132
    Python
    MIT License
    • Apple
    • Linux
  • -
    security
    A
    license
    -
    quality
    An enhanced MCP server that grants AI assistants the ability to execute terminal commands on a user's system with improved security controls, designed for use in controlled environments.
    Last updated -
    Python
    MIT License
    • Apple
  • -
    security
    A
    license
    -
    quality
    An MCP server that analyzes codebases and generates contextual prompts, making it easier for AI assistants to understand and work with code repositories.
    Last updated -
    2
    Python
    MIT License
  • A
    security
    A
    license
    A
    quality
    An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
    Last updated -
    11
    6
    TypeScript
    MIT License
    • Linux
    • Apple

View all related MCP servers

ID: mpixtij6se