local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides system command execution capabilities on macOS, with specific installation paths for the Claude Desktop app configuration on macOS systems.
Herramientas
Las herramientas están disponibles para que las soliciten los estudiantes de maestría, por ejemplo, la aplicación Claude Desktop. Claude Sonnet 3.5 utiliza ambas herramientas de forma inteligente; me sorprendió gratamente.
run_command
- ejecuta un comando, por ejemplo,hostname
ols -al
oecho "hello world"
, etc.- Devuelve STDOUT y STDERR como texto
run_script
- ¡ejecuta un script! (por ejemplo,fish
,bash
,zsh
,python
)- ¡Deja que tu LLM ejecute el código que escribe!
- El script se pasa a través de STDIN
run_script
==run_command
+ script sobre STDIN- ¡Claude ha sido bastante creativo con esto, es decir, ha utilizado
cat
como intérprete para crear nuevos archivos!
[!ADVERTENCIA] ¡Ten cuidado con lo que le pides a este servidor que ejecute! En la aplicación Claude Desktop, usa
Approve Once
(no "Allow for This Chat
") para revisar cada comando. UsaDeny
si no confías en el comando. Los permisos los determina el usuario que ejecuta el servidor. NO lo ejecutes consudo
.
Tutorial en vídeo
Indicaciones
Los mensajes son para que los usuarios los incluyan en el historial de chat, es decir, a través de los comandos de barra de Zed
(en su panel de chat de IA).
run_command
- genera un mensaje de aviso con la salida del comando
Desarrollo
Instalar dependencias:
Construir el servidor:
Para desarrollo con reconstrucción automática:
Instalación
Para utilizar con Claude Desktop, agregue la configuración del servidor:
En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json
Utilice el paquete npm publicado
Publicado en npm como mcp-server-commands usando este flujo de trabajo
Utilice una compilación local (extracción del repositorio)
Explotación florestal
La aplicación Claude Desktop escribe registros en ~/Library/Logs/Claude/mcp-server-mcp-server-commands.log
De forma predeterminada, solo se registran los mensajes importantes (es decir, los errores). Si desea ver más mensajes, añada --verbose
a los args
al configurar el servidor.
Por cierto, los registros se escriben en STDERR
porque es así como Claude Desktop enruta a los archivos de registro. En el futuro, espero que los mensajes de registro con buen formato se escriban mediante el transporte STDIO
al cliente MCP (nota: no a la aplicación Claude Desktop).
Depuración
Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:
El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.
You must be authenticated.
Un servidor MCP para ejecutar comandos.