MCP Client Server

🚀 運行MCP客戶端

本項目用於運行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}'

此命令將：

• 連接到文件系統服務器。
• 列出可用工具。
• 調用 write_file 在指定目錄中創建一個測試文件，如果未在 .env 文件中指定工具。
• 顯示結果到控制檯。

步驟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"}'

• 將上述命令中的路徑替換為您自己的本地路徑。

如果設置正確，您應該會看到確認每個操作的輸出。