shellserver

Python MCP SDK (FastMCP) で構築された、小規模な Model Context Protocol (MCP) サーバーです。サーバープロセスが実行されているマシン上でシェルコマンドを実行するツールを1つ提供します。

要件

• Python 3.14+ (pyproject.toml を参照)

• 依存関係のインストールと実行には uv を使用

Related MCP server: Shell MCP Server

セットアップ

このリポジトリをクローンまたはコピーし、プロジェクトのルートディレクトリから以下を実行します：

uv sync

サーバーの実行

サーバーは stdio トランスポートを使用します（FastMCP のデフォルト）。

uv run python server.py

サーバープロセスから stdout に余分なデータを出力しないでください。MCP は JSON-RPC に stdout を使用します。server.py 内のログは stderr に出力されます。

ツール: terminal_tool

このツールは exit_code、stdout、stderr を含む単一のテキストブロックを返します。コマンドがタイムアウトを超えた場合、プロセスは終了され、レスポンスはタイムアウトを示します。

クライアントの接続（ローカル実行の例）

MCP ホストを uv に向け、このプロジェクトを作業ディレクトリとして指定します。設定例の形式：

{
  "mcpServers": {
    "shellserver": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/absolute/path/to/shellserver"
    }
  }
}

キー名と cwd は、お使いのエディタやクライアントに合わせて調整してください。

セキュリティ

このサーバーはホスト上で任意のシェルコマンドを実行します。このサーバーに対して MCP ツールを呼び出せる者は誰でも、そのマシンへのシェルアクセス権を実質的に持つことになります。信頼できるホスト、信頼できるクライアントでのみ使用し、リスクを十分に理解した上で利用してください。