ShellAgent

Un servidor MCP para ejecutar comandos de shell, que requiere Node.js 18 o más reciente.

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP shellagent-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) para shellagent-mcp

Requisitos

Node.js 18 o superior
VS Code, Cursor, Windsurf, Claude Desktop o cualquier otro cliente MCP

Primeros pasos

Local (Stdio)

Primero, instala el servidor MCP de Commands con tu cliente. Una configuración típica se ve así:

{
  "mcpServers": {
    "shellagent-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-shellagent-mcp@latest"
      ]
    }
  }
}

Instalar en VS Code

También puedes instalar el servidor MCP de shellagent-mcp usando la CLI de VS Code:

# For VS Code
code --add-mcp '{"name":"shellagent-mcp","command":"npx","args":["mcp-server-shellagent-mcp@latest"]}'

Después de la instalación, el servidor MCP de Commands estará disponible para usarse con tu agente de GitHub Copilot en VS Code.

Instalar en Cursor

Ve a Cursor Settings -> MCP -> Add new MCP Server. Ponle el nombre que prefieras, npx mcp-server-shellagent-mcp. También puedes verificar la configuración o agregar argumentos como comandos haciendo clic en Edit.

{
  "mcpServers": {
    "shellagent-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-shellagent-mcp@latest"
      ]
    }
  }
}

Instalar en Windsurf

Sigue la documentación de MCP de Windsurf. Usa la siguiente configuración:

{
  "mcpServers": {
    "shellagent-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-shellagent-mcp@latest"
      ]
    }
  }
}

Instalar en Claude Desktop

Sigue la guía de instalación de MCP, usa la siguiente configuración:

{
  "mcpServers": {
    "shellagent-mcp": {
      "command": "npx",
      "args": [
        "mcp-server-shellagent-mcp@latest"
      ]
    }
  }
}

Remoto (SSE / HTTP Streamable)

Al mismo tiempo, usa el argumento --port $your_port para iniciar el navegador mcp que puede convertirse en un servidor SSE y HTTP Streamable.

# normal run remote mcp server
npx mcp-server-shellagent-mcp --port 8089

Puedes usar uno de los dos endpoints remotos del servidor MCP:

HTTP Streamable (Recomendado): http://127.0.0.1::8089/mcp
SSE: http://127.0.0.1::8089/sse

Y luego, en la configuración del cliente MCP, establece url al endpoint SSE:

{
  "mcpServers": {
    "shellagent-mcp": {
      "url": "http://127.0.0.1::8089/sse"
    }
  }
}

url al HTTP Streamable:

{
  "mcpServers": {
    "shellagent-mcp": {
      "type": "streamable-http", // If there is MCP Client support
      "url": "http://127.0.0.1::8089/mcp"
    }
  }
}

Llamada en memoria

Si tu cliente MCP está desarrollado con JavaScript / TypeScript, puedes usar directamente llamadas en proceso para evitar que tus usuarios necesiten instalar la interfaz de línea de comandos para usar Commands MCP.

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';

// type: module project usage
import { createServer } from 'mcp-server-shellagent-mcp';
// commonjs project usage
// const { createServer } = await import('@agent-infra/mcp-server-commands')

const client = new Client(
  {
    name: 'test commands client',
    version: '1.0',
  },
  {
    capabilities: {},
  },
);

const server = createServer();
const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();

await Promise.all([
  client.connect(clientTransport),
  server.connect(serverTransport),
]);

// list tools
const result = await client.listTools();
console.log(result);

// call tool
const toolResult = await client.callTool({
  name: 'test_tool',
  arguments: {
    hello: 'hello'
  },
});
console.log(toolResult);

Desarrollo

Accede a http://127.0.0.1:6274/:

npm run dev