An MCP server that executes arbitrary commands, enabling flexible control over agent and GUI workflows. It exposes an MCP server interface to run and orchestrate commands in a multimodal environment, supporting a range of agent, vision, browser, and GUI components. The project includes descriptive readme excerpts, badges, and install links to facilitate adoption.

🛠️ Key Features

Runs arbitrary commands via MCP protocol
Integrates with agent, vision, and GUI toolchains
Browser-ready and multimodal operation
Includes installation hooks and VS Code support

🚀 Use Cases

Command-driven agent experimentation
Integrated GUI agent workflows
Vision-guided command execution in browser contexts

⚡ Developer Benefits

Clear MCP-based command execution model
Quick-start install with badges and links
Readme excerpts for onboarding and context

⚠️ Limitations

Specific commands and security constraints are not enumerated in the excerpt
Limited project details in the provided data; refer to repository for full scope

Commands MCP Server

A Model Context Protocol (MCP) server that provides execuate arbitrary commands.

image

Requirements

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

Getting started

Local (Stdio)

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

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest",
        "--cwd",
        "/tmp"
      ]
    }
  }
}

Install in VS Code

You can also install the Commands MCP server using the VS Code CLI:

bash

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

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

Install in Cursor

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx @agent-infra/mcp-server-commands. You can also verify config or add command like arguments via clicking Edit.

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}

Install in Windsurf

Follow Windsuff MCP documentation. Use following configuration:

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}

Install in Claude Desktop

Follow the MCP install guide, use following configuration:

{
  "mcpServers": {
    "commands": {
      "command": "npx",
      "args": [
        "-y",
        "@agent-infra/mcp-server-commands@latest"
      ]
    }
  }
}

Remote (SSE / Streamable HTTP)

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

bash

# normal run remote mcp server
npx @agent-infra/mcp-server-commands --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 the url to the SSE endpoint:

{
  "mcpServers": {
    "commands": {
      "url": "http://127.0.0.1:8089/sse"
    }
  }
}

url to the Streamable HTTP:

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

In-memory call

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 '@agent-infra/mcp-server-commands';
// 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: 'run_script',
  arguments: {
    interpreter: 'node',
    script: 'console.log(1+1);',
  },
});
console.log(toolResult);

Developement

Access http://127.0.0.1:6274/:

bash

npm run dev

io.github.bytedance/mcp-server-commands

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

Commands MCP Server

Requirements

Getting started

Local (Stdio)

Remote (SSE / Streamable HTTP)

In-memory call

Developement

Install

Configuration

Related servers