
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 最新,版权归原站所有,已转换为易读排版。
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 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。