mcp-server-commands

Herramientas

Las herramientas están disponibles para que los LLM las soliciten. Claude Sonnet 3.5 utiliza run_command de forma inteligente. Las pruebas iniciales muestran resultados prometedores con Groq Desktop con los modelos MCP y llama4 .

¡Por ahora, sólo un comando para gobernarlos a todos!

• run_command - ejecuta un comando, por ejemplo, hostname o ls -al o echo "hello world" , etc.
  • Devuelve STDOUT y STDERR como texto
  • El parámetro stdin opcional significa que su LLM puede
    • Pasar código en stdin a comandos como fish , bash , zsh , python
    • Crea archivos con cat >> foo/bar.txt a partir del texto en stdin

[!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. Usa Deny si no confías en el comando. Los permisos los determina el usuario que ejecuta el servidor. NO lo ejecutes con sudo .

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

Groq Desktop (beta, macOS) usa ~/Library/Application Support/groq-desktop-app/settings.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)

Asegúrese de ejecutar npm run build

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.