Skip to main content
Glama
Simple Subprocess MCP Server

Simple Subprocess MCP Server

by yonaka15

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

2. テストクライアントの実行

uv run python test_client.py

3. 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"
})

セキュリティ考慮事項

⚠️ 注意: このサーバーは任意のシェルコマンドを実行できるため、信頼できる環境でのみ使用してください。

推奨される対策

  1. サンドボックス環境での実行

  2. コマンドフィルタリングの実装

  3. 実行権限の制限

  4. ログ監視の実装

ファイル構造

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 tool
run_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

    B3/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that allows LLMs to execute shell commands and receive their output in a controlled manner.
      7
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      A 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.
      15
      19,226 npm
      879
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      A 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
      -