広告掲載
MCP.so
ログイン
S

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

よくある質問

1

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.

2

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.

3

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.

4

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`.

5

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.

コメント

「開発者ツール」の他のコンテンツ

Total CMS

Joe Workman

Read-only Total CMS docs and site content over MCP: exact Twig signatures, field types, schema options, the CLI, release notes and comparisons. No key required.

ArtiBot Cloud MCP - Zhijiangyun 智匠云

bofob

ArtiBot Cloud MCP (Zhijiangyun 智匠云) — cloud MCP server for robot manipulation data & GPU workloads. 15 tools: robot fleet management, data collection & video recording, post-processing pipelines, and benchmark evaluation

1

Termany

thinkany-ai

Agent-Native Terminal

174

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

1

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

1
広告掲載