Terminal Tool MCP Server

ターミナルツール MCP サーバー

このプロジェクトは、FastMCP で構築された MCP（Model Context Protocol）サーバーです。ターミナルコマンドを実行してリモートコンテンツをダウンロードするツールと、ドキュメントにアクセスするためのリソースを提供します。このサーバーは、MCP Tools API を介した安全な非同期コマンド実行とリソース共有のために設計されています。

特長

• ターミナルコマンドの実行： シェルコマンドを非同期で実行し、その出力を取得します。
• 無害なツール： curl を使用してリモートファイルの内容をダウンロードし、返します。
• リソースの公開： resources/MCPREADME.md の内容にリソースとしてアクセスします。

必要条件

• Python 3.8+
• MCP Python SDK
• curl（benign_tool 用）

インストール

1. このリポジトリをクローンします：

   git clone <your-repo-url>
   cd shellserver
   

2. （任意）仮想環境を作成して有効化します：

   python -m venv .venv
   .venv\Scripts\Activate.ps1
   

3. 依存関係をインストールします：

   pip install -r requirements.txt
   

   または、pyproject.toml を使用する場合：

   pip install .
   

サーバーの実行

次のコマンドで MCP サーバーを起動します：

python server.py

サーバーは MCP の標準入出力接続を待ち受けます。

mcp dev での使用

mcp dev CLI を使用して、このサーバーをテストし、操作できます：

1. まだインストールしていない場合は、mcp dev をインストールします：

   pip install mcp-dev
   

2. サーバーを起動します（上記を参照）。
3. 別のターミナルで、次のコマンドを実行します： mcp dev server.py

プロジェクト構成

• server.py – MCP サーバーのメイン実装
• resources/MCPREADME.md – リソースとして公開
• README.md – プロジェクトのドキュメント

ライセンス

MIT ライセンス

作者

Wendy Gasperazzo