Simple Subprocess MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Simple Subprocess MCP Server list all Python files in the current directory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Simple Subprocess MCP Server
シェルコマンドを実行するシンプルなModel Context Protocol (MCP) サーバー
概要
このMCPサーバーは、LLMアプリケーションから任意のシェルコマンドを安全に実行できるツールを提供します。FastMCPフレームワークを使用して構築されており、subprocessモジュールを通じてコマンドを実行します。
Related MCP server: PermShell MCP
機能
任意のシェルコマンドの実行
30秒のタイムアウト設定
エラーハンドリング
標準出力とエラー出力の取得
必要条件
Python 3.11+
uv (パッケージマネージャー)
インストール
# 依存関係をインストール
uv sync使用方法
1. サーバーの起動
# 直接実行
uv run python server.py
# または fastmcp コマンドを使用
uv run fastmcp run server.py2. テストクライアントの実行
uv run python test_client.py3. LLMアプリケーションとの統合
Claude Desktop等のMCP対応アプリケーションで使用する場合、設定ファイルにサーバーのパスを追加してください。
API
run_command(command: str) -> str
指定されたシェルコマンドを実行し、結果を返します。
パラメータ:
command: 実行するシェルコマンド(文字列)
戻り値:
成功時: コマンドの標準出力
エラー時: エラーメッセージ(終了コードとエラー出力を含む)
例:
# ファイル一覧を取得
result = await client.call_tool("run_command", {"command": "ls -la"})
# Webサイトから連絡先情報を抽出
result = await client.call_tool("run_command", {
"command": "curl -sL \"[URL]\" | grep -i contact"
})セキュリティ考慮事項
⚠️ 注意: このサーバーは任意のシェルコマンドを実行できるため、信頼できる環境でのみ使用してください。
推奨される対策
サンドボックス環境での実行
コマンドフィルタリングの実装
実行権限の制限
ログ監視の実装
ファイル構造
simple-subprocess/
├── server.py # MCPサーバーのメイン実装
├── test_client.py # テスト用クライアント
├── pyproject.toml # プロジェクト設定
├── uv.lock # 依存関係ロックファイル
└── README.md # このファイル実装例
Webスクレイピング
curl -sL "[URL]" | grep -i -E "(contact|お問い合わせ|連絡|メール|mail|email|tel|電話)"ファイル操作
# ディレクトリ内容の確認
ls -la
# ファイルの検索
find . -name "*.py" -type f
# テキストファイルの内容確認
cat README.mdシステム情報の取得
# システム情報
uname -a
# ディスク使用量
df -h
# プロセス一覧
ps auxトラブルシューティング
タイムアウトエラー
コマンドの実行時間が30秒を超える場合、タイムアウトエラーが発生します。長時間実行されるコマンドの場合は、server.pyのtimeout値を調整してください。
パーミッションエラー
実行権限が不足している場合は、適切な権限を付与するか、sudo を使用してください(ただし、セキュリティリスクを考慮してください)。
ライセンス
MIT License
貢献
プルリクエストやイシューの報告を歓迎します。
Available Tools
1 toolrun_commandC
Execute a shell command using subprocess and return the output
Inputs: command (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool's purpose is clearly defined and distinct by default.
A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'run_command' follows a clear verb_noun pattern.
One tool is too few for a server's purpose, as it severely limits functionality and scope. This feels thin and inadequate for handling subprocess operations beyond basic command execution.
The server is severely incomplete for subprocess management. It only offers command execution, lacking essential operations like checking process status, handling input/output streams, or managing subprocess lifecycle (e.g., kill, wait).
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
Operate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that allows LLMs to execute shell commands and receive their output in a controlled manner.7MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that allows LLMs to execute shell commands with explicit user permission through desktop notifications.5121MIT
- AlicenseAqualityAmaintenanceA Model Context Protocol server that allows LLMs to securely execute shell commands on remote Linux and Windows systems via SSH. It supports password and key-based authentication, command timeouts, and sudo elevation for administrative tasks.1519,226 npm879MIT
- FlicenseAqualityDmaintenanceA Model Context Protocol server that enables users to execute arbitrary shell commands through a terminal tool. It supports custom working directories, configurable execution timeouts, and safe command parsing using shlex.1-