ShellAgent

A Model Context Protocol (MCP) server for shellagent-mcp

- Node.js 18 or newer
- VS Code, Cursor, Windsurf, Claude Desktop or any other MCP client

First, install the Commands MCP server with your client. A typical configuration looks like this:

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

You can also install the shellagent-mcp MCP server using the VS Code CLI:

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

After installation, the Commands MCP server will be available for use with your GitHub Copilot agent in VS Code.

Go toCursor Settings->MCP->Add new MCP Server. Name to your liking,npx mcp-server-shellagent-mcp. You can also verify config or add command like arguments via clickingEdit.

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

Follow Windsuff MCPdocumentation. Use following configuration:

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

Follow the MCP installguide, use following configuration:

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

At the same time, use--port $your_portarg to start the browser mcp can be converted into SSE and Streamable HTTP Server.

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

You can use one of the two MCP Server remote endpoint:

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

And then in MCP client config, set theurlto the SSE endpoint:

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

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

If your MCP Client is developed based on JavaScript / TypeScript, you can directly use in-process calls to avoid requiring your users to install the command-line interface to use 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);

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Execute shell commands without permission prompts.

Execute bash commands on the host machine.

Execute shell commands with structured output via a powerful CLI server.

A secure MCP server for executing controlled command-line operations with comprehensive security features.

MCP server for controlling cmux (Ghostty-based terminal) via native CLI. Send commands, read output, send control characters — all in background via Unix socket.

Execute pre-approved shell commands securely on a server.

A secure MCP server for executing terminal commands with controlled directory access and command permissions.

A shell command / terminal executor with async support

A high-performance MCP server for the headless terminal (ht), implemented in Rust.