使用说明

项目简介

这是一个使用PHP开发的简单MCP(Model Context Protocol)测试服务器。它旨在演示MCP服务器的基本功能,例如资源管理、工具调用和Prompt模板服务。该服务器主要用于配合仓库自带的Web客户端进行MCP协议的测试和功能验证。

主要功能点

  • 资源管理: 提供示例资源的托管和访问能力。
  • 工具注册与执行: 注册并允许客户端调用预设的工具(例如,加法计算工具)。
  • Prompt模板服务: 定义和提供可定制的Prompt模板,支持客户端获取并执行。
  • 基于Stdio的JSON-RPC通信: 使用标准输入输出流(Stdio)和JSON-RPC协议与MCP客户端进行通信。

安装步骤

  1. 确保你的环境中已安装PHP和Composer。
  2. 克隆此GitHub仓库到本地:
    git clone https://github.com/dependencies-packagist/mcp-testing-server.git
  3. 进入项目目录:
    cd mcp-testing-server
  4. 使用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' 文件作为服务器程序。

基本使用方法

  1. 启动服务器 (通常由客户端自动处理): 虽然可以直接运行 'php server.php' 启动服务器,但此测试仓库主要通过Web客户端界面操作。Web客户端在连接时会自动启动 'server.php'。
  2. 启动Web客户端: 在项目根目录下,使用PHP内置Web服务器启动客户端界面。例如,在终端中运行:
    php -S localhost:8989
    然后在浏览器中访问 'http://localhost:8989'。
  3. 配置并连接服务器: 在Web客户端的 "Server Connection" 面板中, "Command" 字段填写 'php', "Arguments" 字段填写 'server.php'。点击 "Connect to Server" 按钮,客户端将使用配置的命令和参数启动并连接到MCP测试服务器。
  4. 测试MCP功能: 连接成功后,可以使用Web客户端界面上的 "Prompts"、"Tools" 和 "Resources" 面板,测试服务器提供的Prompt模板、工具和资源管理功能。例如,可以列出Prompt模板,执行Prompt,列出工具,调用工具,列出资源,以及读取资源内容。

信息

分类

开发者工具