mcpbash

使用 mcp-go 构建的命令执行 MCP 服务器，支持 stdio 和 HTTP 两种运行模式。

功能

工具	说明
submit_command	提交命令，返回命令ID与初始状态
start_command	启动已提交的命令
get_status	查看命令状态（可选ID，不填返回全部）
get_output	获取命令输出（支持窗口大小与 stdout/stderr）
intervene_command	干预命令（stdin输入或信号）
kill_command	强制结束运行中的命令

环境要求

• Go 1.22+
• Windows 默认使用 PowerShell 作为 shell；非 Windows 默认 bash。
• 如需在 Windows 上使用 bash，请安装 WSL 或 Git Bash，并在提交时设置 shell: "bash"。

快速开始

# 进入项目目录
cd mcpbash

# 整理依赖
go mod tidy

# 构建可执行文件
go build -o mcpbash.exe ./cmd/mcpbash

两种运行模式

1. Stdio 模式（默认）

适用于 MCP 客户端通过标准输入输出连接本进程：

./mcpbash.exe

2. HTTP 模式（远程调用）

适用于通过网络远程调用 MCP 服务：

# 默认端口 8080
./mcpbash.exe -mode http

# 指定端口
./mcpbash.exe -mode http -port 9000

# 绑定特定地址
./mcpbash.exe -mode http -host 127.0.0.1 -port 8080

HTTP 模式下，端点为 POST /mcp，符合 MCP over HTTP 规范。

工具参数说明

submit_command

参数	类型	必填	说明
cmd	string	是	要执行的完整命令字符串
args	string[]	否	额外参数列表（shell模式通常不需要）
env	object	否	环境变量映射
dir	string	否	工作目录
shell	string	否	shell类型，如 bash 或 powershell；Windows默认 powershell，非Windows默认 bash

返回：{ id, status, pid }

start_command

参数	类型	必填	说明
id	string	是	命令ID

返回：命令状态信息

get_status

参数	类型	必填	说明
id	string	否	命令ID；不填返回全部命令状态

返回：状态信息数组或单个状态对象，包含字段：

• id: 命令ID
• status: 状态（pending/running/done/failed/killed）
• pid: 进程PID（运行时有效，结束后为0）
• exitCode: 退出码
• error: 错误信息
• command: 原命令
• shell: 使用的shell
• createdAt: 创建时间
• startedAt: 启动时间
• endedAt: 结束时间

get_output

参数	类型	必填	说明
id	string	是	命令ID
window	number	否	窗口大小（字节数）；默认返回全部
stream	string	否	输出流，stdout 或 stderr；默认 stdout

intervene_command

参数	类型	必填	说明
id	string	是	命令ID
input	string	否	写入到stdin的字符串
signal	string	否	信号类型，如 SIGINT/SIGTERM/SIGKILL

参数 | 类型 | 必填 | kill_command

| 说明 | |------|------|------|------| | id | string | 是 | 命令ID |

注意事项

• Windows 的信号支持受限，当前实现对 signal 在 Windows 上统一为强制结束（Kill）。
• PID 字段在命令启动后有效，命令结束后会自动重置为 0。
• HTTP 模式采用无状态设计，每个请求独立处理。