使用说明
项目简介
这是一个使用PHP开发的简单MCP(Model Context Protocol)测试服务器。它旨在演示MCP服务器的基本功能,例如资源管理、工具调用和Prompt模板服务。该服务器主要用于配合仓库自带的Web客户端进行MCP协议的测试和功能验证。
主要功能点
- 资源管理: 提供示例资源的托管和访问能力。
- 工具注册与执行: 注册并允许客户端调用预设的工具(例如,加法计算工具)。
- Prompt模板服务: 定义和提供可定制的Prompt模板,支持客户端获取并执行。
- 基于Stdio的JSON-RPC通信: 使用标准输入输出流(Stdio)和JSON-RPC协议与MCP客户端进行通信。
安装步骤
- 确保你的环境中已安装PHP和Composer。
- 克隆此GitHub仓库到本地:
git clone https://github.com/dependencies-packagist/mcp-testing-server.git - 进入项目目录:
cd mcp-testing-server - 使用Composer安装项目依赖:
composer install
服务器配置
MCP服务器是为MCP客户端提供服务的后端应用。要使MCP客户端连接到此测试服务器,需要在客户端中配置服务器的启动命令和参数。
对于此仓库中的MCP测试服务器,客户端需要配置以下信息:
{ "serverName": "mcp-test-server", "command": "php", "args": ["server.php"] }
- 'serverName': 服务器名称,可以自定义,例如 "mcp-test-server"。
- 'command': 启动服务器的命令,这里是 'php',表示使用PHP解释器。
- 'args': 命令参数,是一个字符串数组。对于此服务器,参数是 '["server.php"]',指定执行 'server.php' 文件作为服务器程序。
基本使用方法
- 启动服务器 (通常由客户端自动处理): 虽然可以直接运行 'php server.php' 启动服务器,但此测试仓库主要通过Web客户端界面操作。Web客户端在连接时会自动启动 'server.php'。
- 启动Web客户端: 在项目根目录下,使用PHP内置Web服务器启动客户端界面。例如,在终端中运行:
然后在浏览器中访问 'http://localhost:8989'。php -S localhost:8989 - 配置并连接服务器: 在Web客户端的 "Server Connection" 面板中, "Command" 字段填写 'php', "Arguments" 字段填写 'server.php'。点击 "Connect to Server" 按钮,客户端将使用配置的命令和参数启动并连接到MCP测试服务器。
- 测试MCP功能: 连接成功后,可以使用Web客户端界面上的 "Prompts"、"Tools" 和 "Resources" 面板,测试服务器提供的Prompt模板、工具和资源管理功能。例如,可以列出Prompt模板,执行Prompt,列出工具,调用工具,列出资源,以及读取资源内容。
信息
分类
开发者工具