Código de SkyDeckAI

Un servidor MCP que proporciona un conjunto completo de herramientas para flujos de trabajo de desarrollo basados en IA. Sus funciones incluyen operaciones del sistema de archivos, análisis de código mediante tree-sitter para múltiples lenguajes de programación, operaciones Git, ejecución de código, obtención de contenido web con conversión de HTML a Markdown, búsqueda web multimotor, búsqueda de contenido de código, detección de linting y recuperación de información del sistema. Diseñado para mejorar la capacidad de la IA para asistir en las tareas de desarrollo de software, proporcionando acceso directo a recursos locales y remotos.

Anteriormente conocido como MCP-Server-AIDD

Este servidor mcp se conocía anteriormente como mcp-server-aidd . Se renombró skydeckai-code para atribuir al equipo de SkyDeck.ai la creación de esta aplicación junto con East Agile . Pero lo más importante es que nos dimos cuenta de que el término "Desarrollo Impulsado por IA" (AIDD) no estaba teniendo éxito. La gente no entendía a simple vista de qué se trataba. Ni tampoco los LLM. "Código" era mucho más intuitivo. Y la intuición lingüística es importante en el mundo de la IA agentica.

Instalación

# Using pip
pip install skydeckai-code

Configuración del escritorio de Claude

Añade a tu claude_desktop_config.json :

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

Aplicación SkyDeck AI Helper

Si está utilizando la aplicación SkyDeck AI Helper, puede buscar "SkyDeckAI Code" e instalarlo.

Características principales

Operaciones del sistema de archivos (leer, escribir, editar, mover, copiar, eliminar)
Gestión y navegación de directorios
Análisis de código multilingüe mediante tree-sitter
Detección de errores y pelusa de código para Python y JavaScript/TypeScript
Búsqueda de contenido de código con coincidencia de patrones de expresiones regulares
Ejecución de código en varios idiomas con medidas de seguridad
Operaciones de Git (estado, diferencia, confirmación, gestión de ramas, clonación)
Obtención de contenido web desde API y sitios web con conversión de HTML a Markdown
Búsqueda web multimotor con mecanismos de respaldo confiables
Operaciones por lotes para ejecución de herramientas en paralelo y en serie
Controles de seguridad con límites de espacio de trabajo configurables
Herramientas de captura de pantalla y contexto de pantalla
Herramientas de manejo de imágenes

Herramientas disponibles

Operaciones básicas con archivos

Herramienta	Parámetros	Devoluciones
leer_archivo	ruta: cadena, desplazamiento?: entero, límite?: entero	Contenido del archivo (total o parcial)
leer_múltiples_archivos	rutas: cadena[]	Contenido de varios archivos con encabezados
escribir_archivo	ruta: cadena, contenido: cadena	Confirmación de éxito
mover_archivo	origen: cadena, destino: cadena	Confirmación de éxito
copiar_archivo	origen: cadena, destino: cadena, recursivo?: booleano	Confirmación de éxito
eliminar_archivo	ruta: cadena	Confirmación de éxito
obtener_información_del_archivo	ruta: cadena	Metadatos del archivo (tamaño, marcas de tiempo, permisos)

Uso común:

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

Operaciones complejas con archivos

archivo_de_edición

Edición de archivos basada en patrones con soporte de vista previa:

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

Devoluciones: Diferencia de cambios o vista previa en modo de ejecución en seco.

Operaciones de directorio

Herramienta	Parámetros	Devoluciones
obtener_directorio_permitido	ninguno	Ruta de directorio permitida actual
actualización_directorio_permitido	directorio: cadena (ruta absoluta)	Confirmación de éxito
directorio_de_lista	ruta: cadena	Lista de contenidos del directorio
crear_directorio	ruta: cadena	Confirmación de éxito
archivos de búsqueda	patrón: cadena, ruta?: cadena, include_hidden?: booleano	Lista de archivos coincidentes

La herramienta search_files busca archivos por patrón de nombre, mientras que la herramienta search_code busca dentro del contenido del archivo mediante expresiones regulares. Use search_files para buscar archivos con nombres o extensiones específicos, y search_code para buscar patrones de texto específicos dentro de los archivos.

árbol de directorios

Genera la estructura de directorio completa:

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

Devuelve: Estructura de árbol JSON del contenido del directorio.

Uso común:

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

Operaciones de Git

Herramienta	Parámetros	Devoluciones
git_init	ruta: cadena, rama_inicial?: cadena	Estado de inicialización del repositorio
estado de git	repo_path: cadena	Estado del directorio de trabajo
git_add	repo_path: cadena, archivos: cadena[]	Confirmación de puesta en escena
git_reset	repo_path: cadena	Confirmación de desorganización
git_checkout	repo_path: cadena, nombre_de_rama: cadena	Confirmación de cambio de rama
git_crear_rama	repo_path: cadena, branch_name: cadena	Confirmación de creación de rama
clon de git	url: cadena, ruta_de_destino: cadena, rama?: cadena	Confirmación de clonación
git_diff_unstaged	repo_path: cadena	Diferencia entre cambios no programados
git_diff_staged	repo_path: cadena	Los cambios por etapas diff
git_show	repo_path: cadena, commit_hash: cadena	Detalles de una confirmación específica

Operaciones complejas de Git

confirmación git

{
    "repo_path": ".",
    "message": "feat: add new feature"
}

Devuelve: hash de confirmación y confirmación.

git_diff

{
    "repo_path": ".",
    "target": "main"
}

Devoluciones: Salida de diferencia detallada que muestra todos los cambios entre la rama actual y la rama o confirmación de destino especificada.

registro de git

{
    "repo_path": ".",
    "max_count": 10
}

Devuelve: Matriz de entradas de confirmación con hash, autor, fecha y mensaje.

Uso común:

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

Análisis de código

mapeador de base de código

Analiza la estructura del código fuente:

{
    "path": "src"
}

Devoluciones:

Clases y sus métodos
Funciones y parámetros
Estructura del módulo
Estadísticas de organización del código
Relaciones de herencia

Idiomas admitidos:

Python (.py)
JavaScript (.js, .jsx, .mjs, .cjs)
TypeScript (.ts, .tsx)
Java (.java)
C++ (.cpp, .hpp, .cc)
Rubí (.rb, .rake)
Ir (.go)
Óxido (.rs)
PHP (.php)
C# (.cs)
Kotlin (.kt, .kts)

comprobar_pelusa

Comprueba si hay problemas de linting en tu código base utilizando herramientas de linting nativas:

{
    "path": "src",
    "languages": ["python", "javascript"],
    "linters": {
        "pylint": "--disable=C0111",
        "flake8": true,
        "eslint": "--fix"
    },
    "max_issues": 100
}

Parámetros:

Parámetro	Tipo	Requerido	Descripción
camino	cadena	No	Directorio o archivo a analizar (predeterminado: ".")
idiomas	formación	No	Lista de idiomas para analizar (detecta automáticamente si está vacía)
borras	objeto	No	Configuración para linters específicos: se pueden usar valores booleanos o argumentos CLI
problemas máximos	entero	No	Número máximo de ejemplares a devolver (predeterminado: 100, 0 para ilimitado)

Devuelve: Un informe detallado de los problemas de linting detectados en el código base, incluyendo rutas de archivo, números de línea, descripciones de los problemas y niveles de gravedad. Los problemas se agrupan por archivo y se ordenan por gravedad.

Idiomas y linters compatibles:

Python: pylint, flake8 (utiliza automáticamente lo que está disponible)
JavaScript/TypeScript: ESLint
Dart/Flutter: dart_analyze (también informa errores de compilación)

Ejemplo de uso:

# Check entire codebase with default settings
skydeckai-code-cli --tool check_lint

# Check specific directory with custom pylint flags
skydeckai-code-cli --tool check_lint --args '{
    "path": "src",
    "linters": {
        "pylint": "--disable=missing-docstring,invalid-name"
    }
}'

# Check only Python files and disable flake8
skydeckai-code-cli --tool check_lint --args '{
    "path": "src",
    "languages": ["python"],
    "linters": {
        "flake8": false
    }
}'

# Check Dart/Flutter files for linting and compilation errors
skydeckai-code-cli --tool check_lint --args '{
    "path": "lib",
    "languages": ["dart"],
    "linters": {
        "dart_analyze": "--fatal-infos"
    }
}'

código de búsqueda

Herramienta de búsqueda rápida de contenido mediante expresiones regulares:

{
    "pattern": "function\\s+\\w+",
    "include": "*.js",
    "exclude": "node_modules/**",
    "max_results": 50,
    "case_sensitive": false,
    "path": "src"
}

Parámetros:

Parámetro	Tipo	Requerido	Descripción
patrón	cadena	Sí	Patrón de expresión regular para buscar en el contenido del archivo
incluir	cadena	No	Patrón de archivo a incluir (sintaxis glob, predeterminado: "*")
excluir	cadena	No	Patrón de archivo a excluir (sintaxis glob, predeterminado: "")
resultados máximos	entero	No	Máximo de resultados a devolver (predeterminado: 100)
distingue mayúsculas y minúsculas	booleano	No	Si la búsqueda distingue entre mayúsculas y minúsculas (valor predeterminado: falso)
camino	cadena	No	Directorio base desde el cual buscar (predeterminado: ".")

Devoluciones: Líneas coincidentes agrupadas por archivo con números de línea, ordenadas por hora de modificación del archivo con los archivos más nuevos primero.

Esta herramienta utiliza ripgrep cuando está disponible para un rendimiento óptimo, con una implementación alternativa de Python. Es ideal para encontrar patrones de código específicos, como declaraciones de funciones, importaciones, usos de variables o gestión de errores.

Ejemplo de uso:

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

Información del sistema

Herramienta	Parámetros	Devoluciones
obtener_información_del_sistema	ninguno	Detalles completos del sistema

Devoluciones:

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

Proporciona información esencial del sistema en un formato limpio y legible.

# Get system information
skydeckai-code-cli --tool get_system_info

Contexto de pantalla y herramientas de imagen

obtener_aplicaciones_activas

Devuelve una lista de aplicaciones actualmente activas en el sistema del usuario.

{
    "with_details": true
}

Parámetros:

Parámetro	Tipo	Requerido	Descripción
con_detalles	booleano	No	Si se deben incluir detalles adicionales sobre cada aplicación (predeterminado: falso)

Devoluciones:

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

Esta herramienta proporciona un contexto valioso sobre las aplicaciones que se están ejecutando actualmente en el sistema del usuario, lo que puede ayudar a brindar asistencia más relevante.

obtener_ventanas_disponibles

Devuelve información detallada sobre todas las ventanas disponibles que se muestran actualmente en la pantalla del usuario.

{}

Devoluciones:

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

Esta herramienta ayuda a comprender lo que está visible en la pantalla del usuario y puede utilizarse para brindar asistencia según el contexto.

capturar_captura_de_pantalla

Captura una captura de pantalla de la pantalla del usuario o de una ventana específica.

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

Parámetros:

Parámetro	Tipo	Requerido	Descripción
ruta_de_salida	cadena	No	Ruta donde se debe guardar la captura de pantalla (predeterminado: ruta generada)
modo de captura	objeto	No	Especifica qué capturar
modo_de_captura.tipo	cadena	No	Tipo de captura de pantalla: 'completa', 'ventana_activa' o 'ventana_con_nombre' (predeterminado: 'completa')
modo_de_captura.nombre_de_ventana	cadena	No	Nombre de la ventana a capturar (obligatorio cuando el tipo es 'named_window')

Devoluciones:

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

Esta herramienta captura capturas de pantalla para visualización, depuración o asistencia según el contexto.

leer archivo de imagen

Lee un archivo de imagen del sistema de archivos y devuelve su contenido como una cadena codificada en base64.

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

Parámetros:

Parámetro	Tipo	Requerido	Descripción
camino	cadena	Sí	Ruta al archivo de imagen para leer
tamaño máximo	entero	No	Tamaño máximo de archivo en bytes (predeterminado: 100 MB)

Devuelve: datos de imagen codificados en Base64 que se pueden mostrar o procesar.

Esta herramienta admite formatos de imagen comunes como PNG, JPEG, GIF y WebP, y redimensiona automáticamente las imágenes para una visualización óptima.

Herramientas web

búsqueda web

Obtiene contenido de una URL y, opcionalmente, lo guarda en un archivo.

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

Parámetros:

Parámetro	Tipo	Requerido	Descripción
URL	cadena	Sí	URL para obtener el contenido (sólo http/https)
encabezados	objeto	No	Encabezados HTTP opcionales para incluir en la solicitud
se acabó el tiempo	entero	No	Tiempo máximo de espera para la respuesta (predeterminado: 10 s)
guardar_en_archivo	cadena	No	Ruta para guardar el contenido de la respuesta (dentro del directorio permitido)
convertir_html_a_markdown	booleano	No	Cuando es verdadero, convierte el contenido HTML a Markdown para una mejor legibilidad (valor predeterminado: verdadero)

Devuelve: El contenido de la respuesta se muestra como texto con el código de estado HTTP y la información del tamaño. Para el contenido binario, devuelve metadatos y los guarda en un archivo si se solicita. Al habilitar convert_html_to_markdown, el contenido HTML se convierte automáticamente a formato Markdown para una mejor legibilidad.

Esta herramienta se puede utilizar para acceder a API web, obtener documentación o descargar contenido de la web respetando los límites de tamaño (10 MB máximo) y las restricciones de seguridad.

Ejemplo de uso:

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

búsqueda web

Realiza una búsqueda web sólida utilizando múltiples motores de búsqueda y devuelve resultados concisos y relevantes.

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

Parámetros:

Parámetro	Tipo	Requerido	Descripción
consulta	cadena	Sí	La consulta de búsqueda a procesar. Sea específico para obtener mejores resultados.
núm_resultados	entero	No	Número máximo de resultados de búsqueda a devolver (predeterminado: 10, máximo: 20)
convertir_html_a_markdown	booleano	No	Cuando sea verdadero, el contenido se convertirá de HTML a Markdown para una mejor legibilidad (valor predeterminado: verdadero).
motor de búsqueda	cadena	No	Especifica qué motor de búsqueda utilizar: "auto" (predeterminado), "bing" o "duckduckgo"

Devuelve: Una lista de resultados de búsqueda en formato Markdown, que incluye títulos, URL y fragmentos de cada resultado. Los resultados se deduplican y se organizan jerárquicamente para facilitar su lectura.

Esta herramienta utiliza un enfoque multimotor que prueba diferentes motores de búsqueda con diversas estrategias de análisis para garantizar resultados fiables. Puede especificar un motor preferido, pero algunos motores pueden bloquear el acceso automático. En ese caso, la herramienta recurrirá a motores alternativos al seleccionar "automático".

Ejemplo de uso:

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

Herramientas de utilidad

herramientas_de_lote

Ejecute múltiples invocaciones de herramientas en una sola solicitud con ejecución paralela cuando sea posible.

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

Parámetros:

Parámetro	Tipo	Requerido	Descripción
descripción	cadena	Sí	Breve descripción de la operación por lotes
secuencial	booleano	No	Si se deben ejecutar las herramientas en secuencia (predeterminado: falso)
invocaciones	formación	Sí	Lista de invocaciones de herramientas para ejecutar
invocaciones[].tool	cadena	Sí	Nombre de la herramienta a invocar
invocaciones[].argumentos	objeto	Sí	Argumentos para la herramienta especificada

Devuelve: Resultados combinados de todas las invocaciones de herramientas, agrupados por herramienta con su estado de éxito/error. Los resultados se presentan en el orden original de invocación con encabezados de sección claros.

Esta herramienta permite la ejecución eficiente de múltiples operaciones en una sola solicitud. Si sequential predeterminado es "false", las herramientas se ejecutan en paralelo para un mejor rendimiento. Si sequential es "true", las herramientas se ejecutan en orden y, si alguna falla, la ejecución se detiene.

IMPORTANTE : Todas las herramientas del lote se ejecutan en el mismo contexto de directorio de trabajo. Si una herramienta crea un directorio y otra herramienta posterior necesita trabajar dentro de él, debe:

Utilice rutas relativas al directorio de trabajo actual (por ejemplo, "proyecto/src" en lugar de solo "src"), o
Incluya una invocación de herramienta explícita para cambiar directorios usando update_allowed_directory

Ejemplo de uso:

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

pensar

Una herramienta para el razonamiento complejo y la lluvia de ideas sin realizar cambios en el repositorio.

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

Parámetros:

Parámetro	Tipo	Requerido	Descripción
pensamiento	cadena	Sí	Sus pensamientos detallados, análisis o proceso de razonamiento

Devoluciones: Sus pensamientos formateados como Markdown, con una nota que indica que se trató de un ejercicio de reflexión.

Esta herramienta es útil para analizar problemas complejos, generar soluciones o diseñar planes de implementación sin realizar cambios. Es una excelente manera de documentar el proceso de razonamiento, evaluar diferentes enfoques o planificar una estrategia de varios pasos antes de actuar.

Ejemplo de uso:

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

Ejecución de código

código_de_ejecución

Ejecuta código en varios lenguajes de programación con medidas de seguridad y restricciones.

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

Idiomas admitidos:

Python (python3)
JavaScript (Node.js)
Rubí
PHP
Ir
Óxido

Parámetros:

Parámetro	Tipo	Requerido	Descripción
idioma	cadena	Sí	Lenguaje de programación a utilizar
código	cadena	Sí	Código a ejecutar
se acabó el tiempo	entero	No	Tiempo máximo de ejecución (predeterminado: 5 s)

Ejemplo de uso:

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

Requisitos:

Se deben instalar los entornos de ejecución de idiomas respectivos
Los comandos deben estar disponibles en la ruta del sistema
Permisos adecuados para la creación de archivos temporales

⚠️ Advertencia de seguridad: Esta herramienta ejecuta código arbitrario en su sistema. Siempre:

Revisar el código a fondo antes de ejecutarlo
Comprender el propósito del código y el resultado esperado
Nunca ejecute código que no sea de confianza
Tenga en cuenta los posibles impactos en el sistema
Supervisar la salida de la ejecución

ejecutar_script_de_shell

Ejecuta scripts de shell (bash/sh) con medidas de seguridad y restricciones.

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

Parámetros:

Parámetro	Tipo	Requerido	Descripción
guion	cadena	Sí	Script de shell para ejecutar
se acabó el tiempo	entero	No	Tiempo máximo de ejecución (predeterminado: 300 s, máximo: 600 s)

Ejemplo de uso:

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

Características:

Utiliza /bin/sh para lograr la máxima compatibilidad entre sistemas
Se ejecuta dentro del directorio permitido
Salida stdout y stderr separadas
Manejo adecuado de errores y controles de tiempo de espera

⚠️ Advertencia de seguridad: Esta herramienta ejecuta comandos de shell arbitrarios en su sistema. Siempre:

Revise el script a fondo antes de ejecutarlo
Comprender el propósito del guión y el resultado esperado
Nunca ejecute scripts que no sean de confianza
Tenga en cuenta los posibles impactos en el sistema
Supervisar la salida de la ejecución

Configuración

Archivo de configuración: ~/.skydeckai_code/config.json

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

Uso de la CLI

Estructura básica de comando:

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

Depuración

Utilice MCP Inspector para depurar:

npx @modelcontextprotocol/inspector run

Seguridad

Operaciones restringidas al directorio permitido configurado
Prevención de recorrido de ruta
Preservación de permisos de archivos
Manejo seguro de operaciones

Próximas funciones

Herramientas de GitHub:
- Generador de descripciones de relaciones públicas
- Revisión de código
- Administrador de acciones
Herramientas de Pivotal Tracker:
- Generador de historias
- Administrador de historias

Estado de desarrollo

Actualmente en desarrollo. Las características y la API pueden cambiar.

Licencia

Licencia Apache 2.0 - ver LICENCIA

Integrations

Código de SkyDeckAI

Anteriormente conocido como MCP-Server-AIDD

Instalación

Configuración del escritorio de Claude

Aplicación SkyDeck AI Helper

Características principales

Herramientas disponibles

Operaciones básicas con archivos

Operaciones complejas con archivos

archivo_de_edición

Operaciones de directorio

árbol de directorios

Operaciones de Git

Operaciones complejas de Git

confirmación git

git_diff

registro de git

Análisis de código

mapeador de base de código

comprobar_pelusa

código de búsqueda

Información del sistema

Contexto de pantalla y herramientas de imagen

obtener_aplicaciones_activas

obtener_ventanas_disponibles

capturar_captura_de_pantalla

leer archivo de imagen

Herramientas web

búsqueda web

búsqueda web

Herramientas de utilidad

herramientas_de_lote

pensar

Ejecución de código

código_de_ejecución

ejecutar_script_de_shell

Configuración

Uso de la CLI

Depuración

Seguridad

Próximas funciones

Estado de desarrollo

Licencia

Tools

Related Resources

Appeared in Searches