mcp-server-commands

by g0t4

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 o ls -al o echo "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. 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:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

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

{ "mcpServers": { "mcp-server-commands": { "command": "npx", "args": ["mcp-server-commands"] } } }

Utilice una compilación local (extracción del repositorio)

{ "mcpServers": { "mcp-server-commands": { // works b/c of shebang in index.js "command": "/path/to/mcp-server-commands/build/index.js" } } }

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:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor MCP para ejecutar comandos.

  1. Video walkthrough
    1. Prompts
      1. Development
        1. Installation
          1. Use the published npm package
          2. Use a local build (repo checkout)
          3. Logging
          4. Debugging
        ID: 4vlwa2czqa