Simple Subprocess MCP Server

シェルコマンドを実行するシンプルなModel Context Protocol (MCP) サーバー

概要

このMCPサーバーは、LLMアプリケーションから任意のシェルコマンドを安全に実行できるツールを提供します。FastMCPフレームワークを使用して構築されており、subprocessモジュールを通じてコマンドを実行します。

機能

• 任意のシェルコマンドの実行
• 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

貢献

プルリクエストやイシューの報告を歓迎します。