关键词

上下文服务LLM应用后端Prompt模板管理工具集成资源访问

使用说明

项目简介

本项目是一个使用PHP开发的MCP (Model Context Protocol) 服务器示例，旨在演示如何构建符合MCP协议的应用后端，为大型语言模型（LLM）客户端提供标准化、可扩展的上下文服务。通过本服务器，您可以管理Prompt模板、注册和执行Tool工具，以及托管和访问Resource资源，从而增强LLM应用的功能和灵活性。

主要功能点

  • Prompt 处理器: 支持定义和管理Prompt模板，允许LLM客户端获取预定义的Prompt，并支持根据参数动态生成Prompt内容，实现可定制的交互模式。
  • Tool 处理器: 允许注册和管理外部Tool工具，例如示例中的数字加法工具。LLM客户端可以调用这些工具来执行特定的外部功能，扩展LLM的能力边界。
  • Resource 处理器: 提供基础的资源管理和访问功能，可以托管各种类型的数据资源，并允许LLM客户端通过URI访问和读取资源内容。
  • 完整的日志系统: 记录服务器运行日志，方便问题排查和监控。
  • Docker 支持: 提供Docker镜像构建和运行方式，方便部署和集成。

安装步骤

方式一：本地安装

  1. 克隆项目: 
    git clone https://github.com/he426100/php-mcp-server
cd php-mcp-server
  2. 安装依赖: 确保已安装Composer，然后运行： 
    composer install

方式二：Docker 安装

  1. 构建镜像: 确保已安装Docker，然后在项目根目录下运行： 
    docker build -t php-mcp-server .
  2. 运行容器: 
    docker run -it --rm php-mcp-server

服务器配置

MCP客户端需要配置以下JSON格式信息以连接到此MCP服务器。

{
  "serverName": "php-mcp-server",
  "command": "php",
  "args": [
    "bin/console",
    "mcp:test-server"
  ],
  "transport": "stdio"
}

配置参数说明:

  • 'serverName': MCP服务器的名称，这里设置为 "php-mcp-server"。
  • 'command': 启动服务器的命令，这里使用 'php' 命令。
  • 'args': 启动命令的参数列表。
    • '"bin/console"': 指向项目中的命令行入口文件。
    • '"mcp:test-server"': 指定要执行的命令，即启动MCP测试服务器的命令。
  • 'transport': 传输协议，默认为 'stdio' (标准输入输出)。

注意: 请确保您的MCP客户端能够正确执行 'php bin/console mcp:test-server' 命令，并且PHP环境已正确配置。

基本使用方法

本MCP服务器主要通过标准输入输出 (stdio) 与MCP客户端进行通信。启动服务器后，它将监听来自客户端的JSON-RPC请求，并根据请求类型（如 'prompts/list', 'tools/call', 'resources/read' 等）进行处理，然后将JSON-RPC响应返回给客户端。

您需要使用兼容MCP协议的客户端软件或SDK来连接并使用此服务器提供的功能。客户端可以发送请求来：

  • 获取可用的Prompt模板列表和模板内容。
  • 获取可用的Tool工具列表并调用指定Tool执行操作。
  • 获取可用的Resource资源列表并读取指定Resource的内容。

具体的使用方式和请求格式请参考MCP协议文档以及您使用的MCP客户端的文档。

信息

分类

AI与计算

访问项目