Shell Proxy MCP Server

@aliforever

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

aliforever

提交者

Ali Error

关于 Shell Proxy MCP Server

shellproxy is a clean command execution proxy for AI agents, solving the "terminal blindness" problem — garbage characters, ANSI escape codes, shell init noise, and encoding issues that make AI agents unable to read terminal output.

#shell #proxy#cmd#wsl#powershell

Shell Proxy MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "shellproxy": {
      "command": "shellproxy",
      "args": [
        "serve"
      ],
      "env": {
        "SHELLPROXY_SHELL": "auto",
        "SHELLPROXY_STRIP_ANSI": "true",
        "SHELLPROXY_TIMEOUT": "60"
      }
    }
  }
}

Shell Proxy MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Shell Proxy?

Shell Proxy is a clean command execution proxy for AI agents that solves "terminal blindness" — garbage characters, ANSI escape codes, shell init noise, and encoding issues that prevent AI agents from reading terminal output. It sits between AI agents and terminals, executing commands in a controlled environment and returning structured JSON output.

How to use Shell Proxy?

Install Shell Proxy via a one-line script (curl for Unix, irm for Windows) or build from source using Go. Use shellproxy run "<command>" to execute commands locally, or run shellproxy serve to start the MCP server over stdio. Configure behavior via CLI flags, environment variables, or a JSON config file at ~/.shellproxy.json.

Key features of Shell Proxy

Strips ANSI escape codes and control sequences from output
Bypasses shell init files (bash --norc --noprofile, PowerShell -NoProfile)
Automatically detects the best available shell (WSL on Windows, bash/sh on Unix)
Returns structured JSON output with exit_code, stdout, stderr, duration_ms, shell, truncated
Supports streaming mode for line-by-line output of long-running commands
Provides MCP tools run_command and run_command_stream for AI agent integration

Use cases of Shell Proxy

AI agents executing shell commands and needing clean, parseable output
Running commands in automated workflows where ANSI codes would interfere with parsing
Integrating shell command execution into MCP-compatible AI clients like Claude Desktop

常见问题

How does Shell Proxy differ from running a shell directly?

Shell Proxy strips ANSI escape codes, bypasses shell init files, and returns structured JSON instead of raw terminal output, making it ideal for AI agents that cannot parse garbled terminal text.

What shells does Shell Proxy support?

It supports auto-detection and explicit selection of `cmd`, `bash`, `wsl`, `pwsh`, `sh`, and falls back to cmd on Windows and bash/sh on Unix.

What runtime or dependencies are required?

Shell Proxy is a standalone binary that can be installed via install scripts or built from source with Go. No external runtime dependencies are needed beyond the target shell itself.

Where does command output and configuration live?

Output is printed to stdout (or written to a file with `--file`). Configuration lives in environment variables or the JSON config file at `~/.shellproxy.json`.

What are the known limits of Shell Proxy?

Commands can be configured with a timeout (default 60 seconds) and output can be truncated at a specified byte limit. Streaming mode returns data line-by-line for long-running commands.

开发工具分类下的更多 MCP 服务器

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U