运行MCP客户端

在运行此客户端之前，请确保服务器已启动并正常运行。有关更多信息，请参见：https://github.com/dazzaji/filesystem

第一步：创建虚拟环境并正确安装依赖项

使用以下命令：

```bash
mkdir mcp-client-py
cd mcp-client-py
```

```bash
python -m venv venv
source venv/bin/activate
```

```bash
pip install -r requirements.txt
```

此命令创建一个虚拟环境，激活它，然后将 mcp 和 python-dotenv（及其依赖项）安装到该环境中。

第二步：确认或调整.env文件中的环境变量

创建一个 .env 文件，指定服务器路径和允许目录。您还可以指定测试工具和参数。

   SERVER_PATH=/Users/dazzagreenwood/filesystem/dist/index.js
   ALLOWED_DIRECTORY=/Users/dazzagreenwood/mcp-hello/module1/files
   
  # 使用以下参数进行测试：
   #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"}'

第三步：运行Python客户端

运行您的客户端以测试服务器。

 python client.py
 ```
* 如果在 .env 文件中指定了可选的 `TOOL` 和 `ARGS`，请像这样添加这些参数：
 ```bash
     python client.py --tool "list_directory" --args '{"path": "/Users/dazzagreenwood/mcp-hello/module1/files", "recursive": true}'
 ```
此操作将：

* 连接到您的文件系统服务器。
* 列出可用工具。
* 调用 `write_file` 以在指定目录中创建一个测试文件，如果未在 .env 文件中指定工具。
* 将结果显示到控制台。

### 第四步：验证结果

成功运行客户端后，请检查以下内容：

1. **客户端输出**：您应该会看到类似 `Available tools: [ ... ]` 的输出，并显示每个操作的结果。
2. **文件创建**：确认在指定目录中是否正确创建了测试文件。

按照以上说明，您可以使用 Python 和 TypeScript/Node.js 使用各种工具测试 MCP 服务器和客户端！

---

# 测试工作流程

## 启动服务器

1. 打开终端窗口并导航到您的服务器项目目录。
2. 根据 [https://github.com/dazzaji/filesystem](https://github.com/dazzaji/filesystem) 中的说明启动服务器。

## 使用客户端进行测试

1. **使用 `list_directory` 工具**：
```bash
python client.py --server-path /Users/dazzagreenwood/filesystem/dist/index.js --allowed-directory /Users/dazzagreenwood/mcp-hello/module1/files --tool list_directory --args '{"path": "/Users/dazzagreenwood/mcp-hello/module1/files", "recursive": true}'

2. 使用 read_file 工具：

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

• 根据需要调整路径，使其适用于您的本地环境。

如果配置正确，您应该能够看到每个操作的输出，确认其成功执行。