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

• 将上述命令中的路径替换为您自己的本地路径。

如果设置正确，您应该会看到确认每个操作的输出。