返回资讯中心
外部精选
软件工程
#开发者实时流

Astrax – Open-source MCP server for Windows desktop AI control

A.S.T.R.A.X. — Agentic System Telemetry, Realtime Automation & X-control

Hacker News 最新astraxof2026/10/17 · 2026/10/1717 分钟阅读

以下正文同步自 Hacker News 最新,版权归原站所有,已转换为易读排版。

A.S.T.R.A.X. — Agentic System Telemetry, Realtime Automation & X-control

Servidor MCP (Model Context Protocol) en Python que le da a tu IA ojos y manos sobre tu pantalla: ver, hacer clic, escribir y ejecutar tareas de varios pasos sin saturar el contexto.

Compatible con Claude Desktop, Roo Code, Cline, Cursor, Windsurf, Gemini CLI, OpenCode y cualquier cliente MCP con transporte stdio. Funciona con modelos locales (Ollama) y APIs comerciales (Claude, Gemini…).

📺 Tutorial en YouTube: @AstraxOf 💬 Contacto en Telegram: @RufusOficial

Necesitas uv (instala Python y dependencias solo):

macOS / Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Después, un solo comando detecta tu sistema operativo y tus clientes MCP, y registra Astrax en ellos:

uvx --from git+https://github.com/AstraxOf/astrax-mcp.git astrax-install --yes

Reinicia tu cliente (en Claude Desktop, ciérralo por completo) y listo.

Cuando el paquete esté publicado en PyPI bastará uvx astrax-mcp para ejecutar el servidor y uvx --from astrax-mcp astrax-install --yes para instalarlo.

Si eres una IA y el usuario te pide instalar Astrax, ejecuta exactamente esto y pídele que reinicie su cliente MCP. No edites archivos JSON a mano.

uvx --from git+https://github.com/AstraxOf/astrax-mcp.git astrax-install --yes

Variantes útiles:

El instalador solo toca la clave astrax dentro de mcpServers: conserva tus otros servidores, crea una copia .astrax-bak-<fecha> antes de escribir, guarda de forma atómica y no modifica archivos con JSON inválido.

Claude Code: claude mcp add astrax -- uvx --from git+https://github.com/AstraxOf/astrax-mcp.git astrax-mcp

git clone https://github.com/AstraxOf/astrax-mcp.git cd astrax-mcp python install.py # asistente interactivo (equivale a astrax-install)

🧠 Motor paso a paso por estado temporal

Los modelos ligeros (Ollama) se saturan y alucinan cuando el contexto crece con historial y capturas de pantalla viejas. Astrax lo evita aislando el contexto en un archivo de estado local: .astrax_task_state.json.

Antes de ejecutar nada, la IA declara todo lo que necesitará la tarea completa en astrax_tarea_crear:

Después muestra el plan y los permisos, pide tu confirmación una sola vez y llama a astrax_tarea_autorizar. Desde ese momento puede trabajar de forma desatendida durante la sesión (60 min por defecto, ASTRAX_SESSION_MINUTES). Las herramientas de acción rechazan cualquier uso fuera de una tarea autorizada o de un permiso no solicitado.

Cómo evitar las confirmaciones por paso en tu cliente: el servidor no puede saltarse las confirmaciones que muestra el cliente. Por eso astrax-install --auto-approve (Roo Code / Cline) marca como "permitir siempre" todas las herramientas excepto astrax_tarea_autorizar: tu cliente te pregunta una vez, justo en la autorización, y no durante la ejecución. En otros clientes (p. ej. Claude Desktop) elige "Permitir siempre" en esa herramienta o en el resto cuando te lo pida.

Para volver al comportamiento anterior sin tareas ni sesiones: ASTRAX_REQUIRE_SESSION=0.

Herramienta Descripción

astrax_tarea_crear Guarda el plan por pasos y los permisos que necesita la tarea completa

astrax_tarea_autorizar Concede los permisos tras la confirmación del usuario

astrax_tarea_estado Lee el paso actual, el siguiente y los datos guardados

astrax_tarea_guardar Guarda un dato clave (rutas, ids…)

astrax_tarea_completar_paso Cierra el paso, guarda salidas y devuelve el siguiente

astrax_tarea_limpiar Borra el estado y las capturas temporales

astrax_ver_pantalla La IA ve la pantalla: captura como imagen (marca roja en el cursor)

astrax_capturar_pantalla Guarda un PNG y devuelve la ruta

astrax_info_pantalla Ancho y alto de la pantalla

astrax_clic / astrax_doble_clic Clic en (x, y) con validación de límites

astrax_escribir Teclea texto (soporta ñ, tildes y emojis vía portapapeles)

astrax_tecla / astrax_atajo Teclas sueltas y atajos (["ctrl", "t"]…)

astrax_scroll Rueda del ratón arriba/abajo

astrax_esperar Espera a que cargue una app o página

astrax_portapapeles Lee o escribe el portapapeles

astrax_ejecutar_comando Ejecuta un comando de shell con timeout y salida recortada

Ejemplo de prompt:

"Usa Astrax: redacta una carta para Ana con mis datos, guárdala como PDF y envíala a ana@ejemplo.com con el asunto 'Propuesta'."

Si prefieres no usar el instalador, añade esto a tu mcp_settings.json (o al archivo equivalente de tu cliente):

{ "mcpServers": { "astrax": { "command": "uvx", "args": ["--from", "git+https://github.com/AstraxOf/astrax-mcp.git", "astrax-mcp"] } } }

En clientes de escritorio que no heredan tu PATH, usa la ruta absoluta de uvx (which uvx / where uvx). El instalador ya lo hace por ti.

Astrax controla tu ratón, teclado y (si lo autorizas) tu terminal reales. Úsalo con cabeza:

Windows: funciona sin configuración extra.

macOS: concede permisos de Grabación de pantalla y Accesibilidad a tu terminal o editor.

Linux: funciona en X11 (Wayland suele bloquear captura y control). Puede hacer falta sudo apt install python3-tk python3-dev scrot xclip.

🧩 Arquitectura

astrax-mcp/ ├── pyproject.toml # entry points: astrax-mcp, astrax-install ├── install.py # atajo para quien clona el repo ├── mcp_settings.json # ejemplo (Roo Code / Cline) ├── tests/ └── src/astrax_mcp/ ├── server.py # construye el servidor y registra los módulos ├── config.py # constantes, rutas y variables ASTRAX_* ├── state.py # motor del archivo de estado de tareas (sin dependencias de MCP) ├── tasks.py # herramientas MCP del gestor de tareas ├── permissions.py # verificación de permisos de sesión ├── vision.py # captura y visión de pantalla ├── control.py # ratón, teclado, scroll, esperas ├── system.py # terminal y portapapeles ├── gui.py # acceso perezoso a pyautogui + validaciones ├── utils.py # log a stderr, errores uniformes, truncado ├── compat.py # SDK MCP v1 (FastMCP) / v2 (MCPServer) └── installer.py # wizard de instalación multiplataforma

Basado en el SDK oficial de MCP para Python. compat.py usa MCPServer (v2) y recurre a FastMCP (v1.x); pyproject.toml fija mcp<2 como en la configuración original: quita el tope cuando pruebes el SDK v2.

Transporte stdio; todos los logs van a stderr para no corromper el flujo JSON-RPC.

Las capturas se normalizan al tamaño lógico de pantalla: las coordenadas de la imagen coinciden con las del clic, incluso en HiDPI/Retina. La calidad JPEG se ajusta con ASTRAX_JPEG_QUALITY (30-95, por defecto 65).

Tests: pip install -e ".[dev]" && pytest

🤝 Contribuciones / Community

Astrax es Open Source y crece con la comunidad. Si quieres sumarte, eres bienvenido: puedes abrir issues, enviar pull requests, proponer ideas, probar Astrax en otros sistemas o clientes MCP y reportar errores.

Si te sirvió el proyecto, deja una ⭐ en el repositorio y suscríbete al canal.

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →