MCP Client Server

🚀 MCPクライアントの実行

このクライアントを実行する前に、サーバーが起動して正常に動作していることを確認してください。詳細については、https://github.com/dazzaji/filesystem を参照してください。

🚀 クイックスタート

ステップ1：仮想環境の作成と依存関係のインストール

以下のコマンドを使用して、仮想環境を作成し、依存関係をインストールします。

mkdir mcp-client-py
cd mcp-client-py

python -m venv venv
source venv/bin/activate

pip install -r requirements.txt

これらのコマンドは、仮想環境を作成し、それをアクティブ化してから、mcp と python-dotenv（およびその依存関係）をその環境にインストールします。

ステップ2：.envファイルの環境変数の確認または修正

.env ファイルを作成し、サーバーパスと許可されたディレクトリを指定します。また、テスト用のツールとパラメーターを指定することもできます。

SERVER_PATH=/Users/dazzagreenwood/filesystem/dist/index.js
ALLOWED_DIRECTORY=/Users/dazzagreenwood/mcp-hello/module1/files

# テスト用のオプションTOOLとARGS：
# TOOL=list_directory
# ARGS='{"path": "/Users/dazzagreenwood/mcp-hello/module1/files", "recursive": true}'

# または他のツールでテストする場合
# TOOL=read_file
# ARGS='{"path": "/Users/dazzagreenwood/mcp-hello/module1/files/test.txt"}'

ステップ3：Pythonクライアントの実行

クライアントを実行してサーバーをテストします。

python client.py

• オプションの TOOL と ARGS を使用した場合は、次のようにこれらのパラメーターを追加します。

python client.py --tool "list_directory" --args '{"path": "/Users/dazzagreenwood/mcp-hello/module1/files", "recursive": true}'

このコマンドは、以下のことを行います。

• ファイルシステムサーバーに接続します。
• 利用可能なツールを一覧表示します。
• .env ファイルでツールが指定されていない場合、指定されたディレクトリに write_file を呼び出してテストファイルを作成します。
• 結果をコンソールに表示します。

ステップ4：結果の検証

クライアントが正常に実行された後、以下のことを確認してください。

1. クライアント出力：Available tools: [ ... ] のような出力が表示され、write_file（または他のツール呼び出し）の結果が表示されるはずです。
2. ファイルの作成：/Users/dazzagreenwood/mcp-hello/module1/files/ ディレクトリに testfile.txt ファイルが作成され、内容が正しいことを確認してください。

テストワークフロー

以下は、クライアントとサーバーを使用して検証する手順です。

サーバーの起動

1. ターミナルを開く：サーバーをターミナルから起動する必要があります。
2. サーバーディレクトリに移動する：サーバーファイルを含むフォルダにディレクトリを変更します。

   cd /Users/dazzagreenwood/filesystem
   

3. サーバーを実行する：

   node dist/index.js "/Users/dazzagreenwood/mcp-hello/module1/files"
   

   • /Users/dazzagreenwood/filesystem/dist/index.js を実際のコンパイル済みファイルのパスに置き換えてください。
   • /Users/dazzagreenwood/mcp-hello/module1/files を許可されたディレクトリに置き換えてください。

クライアントを使用したテスト

1. 別のターミナルウィンドウを開く または現在のターミナルタブを分割します。

2. クライアントディレクトリに移動する：mcp-client-py フォルダにディレクトリを変更します。

   cd /Users/dazzagreenwood/mcp-client-server/mcp-client-py
   source .venv/bin/activate
   

3. デフォルトモードでクライアントを実行する： 基本的な接続性と write_file ツールをテストするために、次のコマンドを実行します。

    python client.py
   

   このコマンドは、/Users/dazzagreenwood/mcp-hello/module1/files ディレクトリに test.txt という名前のファイルを作成し、その内容を Hello, World! に設定するために書き込みファイルを呼び出そうとします。

4. 他のテストを実行する： 以下のコマンドを使用して他のツールをテストすることができます。

   • list_directory ツールをテストする：

      python client.py --tool "list_directory" --args '{"path": "/Users/dazzagreenwood/mcp-hello/module1/files", "recursive": true}'
     

   • read_file ツールをテストする：

      python client.py --server-path /Users/dazzagreenwood/filesystem/dist/index.js --allowed-dir /Users/dazzagreenwood/mcp-hello/module1/files --tool read_file --args '{"path": "/Users/dazzagreenwood/mcp-hello/module1/files/test.txt"}'
     

   • 上記のコマンドのパスを自分のローカルパスに置き換えてください。

設定が正しければ、各操作を確認する出力が表示されるはずです。