Mcp Server Commands

io.github.bytedance由 GitHub 帳號 bytedance 發布v1.0.0更新於 Oct 25, 2026

An MCP server to run arbitrary commands

概覽

AI 產生的概覽

一個本機 MCP 伺服器,讓 AI 助理在使用者機器上執行任意命令並執行腳本。

可以做什麼
透過伺服器的命令執行工具在本機執行任意命令,啟動時可用工作目錄參數(例如 --cwd)限定位置。依解譯器名稱執行腳本片段,例如記憶體內呼叫範例中以 node 解譯器呼叫 run_script。可作為 stdio 本機程序執行,也可用指定連接埠啟動為 Streamable HTTP 或 SSE 端點供遠端用戶端連線。可在 JavaScript 或 TypeScript 的 MCP 用戶端中透過行程內呼叫嵌入,無須安裝命令列工具。
適用情境
適合助理需要在你自己的機器上執行 shell 命令或短腳本的開發情境,例如檢視檔案、執行建置或測試步驟、自動化本機工作。它是通用的命令執行通道,適用於你已信任用戶端並希望直接取得命令存取權限的環境。
執行需求
需要 Node.js 18 或更新版本,以及 VS Code、Cursor、Windsurf 或 Claude Desktop 等 MCP 用戶端。透過 npm 套件 @agent-infra/mcp-server-commands 安裝,通常以 npx 啟動。未宣告驗證、環境變數或標頭。遠端模式需以連接埠參數啟動。
安裝前請注意
它會在你的機器上執行任意命令,助理被誘導執行的任何內容都會以你的使用者權限執行,可能讀取、修改或刪除檔案並存取網路。未宣告任何驗證,因此遠端 HTTP 或 SSE 端點不應暴露在 localhost 之外。核准前請檢查命令,並考慮限制工作目錄。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp Server Commands,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Commands MCP Server

[NPM Downloads]

[Install MCP Server] [Install in VS Code] [Install in VS Code Insiders]

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

[圖片]

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:

js
{  "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 Codecode --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.

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

Follow Windsuff MCP documentation. Use following configuration:

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

Follow the MCP install guide, use following configuration:

js
{  "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 servernpx @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:

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

url to the Streamable HTTP:

js
{  "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.

js
import { Client } from '@modelcontextprotocol/sdk/client/index.js';import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
// type: module project usageimport { 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 toolsconst result = await client.listTools();console.log(result);
// call toolconst 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

來源:packages/agent-infra/mcp-servers/commands/README.md,提交 2ff41a9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分