Script Tool

脚本工具

通过 MCP 执行命令行脚本的工具。

功能

• 安全执行命令行脚本
• 支持不同的解释器
• 超时保护
• 捕获输出和错误
• 跨平台支持（Linux、macOS、Windows）

安装

安装脚本工具有以下几种方式：

选项 1：从 GitHub Releases 下载

1. 访问 GitHub Releases 页面
2. 下载适用于你平台的二进制文件：
   • script-mcp_linux_amd64`（Linux）
   • script-mcp_darwin_amd64（macOS）
   • script-mcp_windows_amd64.exe（Windows）
3. 使二进制文件可执行（Linux/macOS）：

   chmod +x script-mcp_*
   

4. 将其移至你的 PATH 中（Linux/macOS）：

   sudo mv script-mcp_* /usr/local/bin/script-mcp@latest
   

选项 2：使用 Go 安装

go install github.com/nguyenvanduocit/script-mcp

配置

Claude

{
  "mcpServers": {
    "script": {
      "command": "/path-to/script-mcp"
    }
  }
}

CLI 用法

除了 MCP 服务，script-mcp 还提供独立的 CLI 二进制文件（script-cli），可直接在终端中使用，无需 MCP 客户端。

安装

just install-cli
# or
go install github.com/nguyenvanduocit/script-mcp/cmd/script-cli@latest

快速开始

无需凭据。CLI 会在本地执行脚本。

script-cli execute --content "echo Hello, World!"

命令

命令	描述
execute（或 exec、run）	安全执行脚本并设置超时

示例

# Run a shell command
script-cli execute --content "ls -la"

# Run with a specific interpreter
script-cli execute --content "print('Hello')" --interpreter /usr/bin/python3

# Run with a working directory
script-cli execute --content "pwd" --working-dir /tmp

# Run a multi-line script
script-cli execute --content "#!/bin/bash
echo 'Starting...'
date
echo 'Done'"

# JSON output (captures stdout/stderr separately)
script-cli exec --content "echo hello" --output json

标志

标志	描述
--content	要执行的脚本内容（必填）
--interpreter	解释器路径（默认值：/bin/sh）
--working-dir	执行时使用的工作目录
--env	.env 文件的路径
--output	输出格式：text（默认值）或 json

注意： 脚本会在 30 秒后超时。

贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

安装

Homebrew（macOS/Linux）

brew install nguyenvanduocit/tap/script-mcp