About PHP MCP Server

What is PHP MCP Server: Effortless Scalability & Snappy Performance?

PHP MCP Server is an open-source implementation of the Model Control Protocol (MCP), designed to handle prompt, tool, and resource operations with minimal overhead. Built on PHP 8.1+, this lightweight server provides a modular architecture for managing AI-driven workflows, backed by a robust logging system and optional Docker orchestration. Its architecture prioritizes seamless scaling and low-latency responses to meet modern application demands.

How to Use PHP MCP Server: Effortless Scalability & Snappy Performance?

Getting started is straightforward:

Clone the repository and install dependencies via Composer
Choose your preferred runtime environment:
- Local: Run php bin/console directly
- Containerized: Deploy with docker run -i --rm php-mcp-server
Access core features through standardized MCP protocol endpoints

PHP MCP Server Features

Key Features of PHP MCP Server: Effortless Scalability & Snappy Performance?

Prompt Processor: Manages template storage and retrieval with intuitive API
Tool Processor: Includes operational example (addition tool) and extensible framework for custom functions
Resource Access: Securely serves stored resources via standardized endpoints
Production-Ready Logging: Centralized logging with timezone-aware timestamps
Scalability: Docker-native support and low memory footprint (default 1G)

Use Cases of PHP MCP Server: Effortless Scalability & Snappy Performance?

Typical applications include:

Building AI-powered chatbots requiring prompt management
Testing MCP protocol integrations in PHP environments
Creating serverless microservices for tool execution
Resource management for ML model artifacts
Performance benchmarking of PHP-based control systems

PHP MCP Server FAQ

FAQ from PHP MCP Server: Effortless Scalability & Snappy Performance?

How do I customize logging? Adjust the LoggerService configuration in src/Service/LoggerService.php
Can I reduce memory usage? Set PHP_MEMORY_LIMIT environment variable to lower values
What development tools are included? Built-in PHPStan analysis and PHP_CodeSniffer for code quality
Does it work with PHP 8.2? Fully compatible, tested up to latest PHP versions
Where's the community support? Visit the project author's GitHub for issues and contributions

Content

PHP MCP Server

这是一个基于 PHP 实现的 MCP (Model Control Protocol) 服务器示例项目。

项目概述

本项目提供了一个完整的 MCP 服务器实现，包含以下功能：

Prompt 处理器
Tool 处理器
Resource 处理器
完整的日志系统
Docker 支持

系统要求

PHP >= 8.1
Composer
Docker (可选)

安装

方式一：本地安装

克隆项目

git clone https://github.com/he426100/php-mcp-server
cd php-mcp-server

安装依赖

composer install

运行服务器

php bin/console

方式二：Docker 安装

构建镜像

docker build -t php-mcp-server .

运行容器

docker run -i --rm php-mcp-server

项目结构

.
├── bin/
│   └── console              # 命令行入口文件
├── src/
│   ├── Command/
│   │   └── TestServerCommand.php    # MCP 服务器命令实现
│   └── Service/
│       └── LoggerService.php        # 日志服务
├── runtime/                 # 运行时文件目录
├── composer.json           # Composer 配置文件
├── Dockerfile             # Docker 构建文件
└── README.md              # 项目说明文档

功能说明

1. Prompt 处理器

提供示例提示模板，支持：

列出可用的提示模板
获取特定提示模板内容

2. Tool 处理器

实现了一个简单的数字加法工具，支持：

列出可用工具
调用工具执行操作

3. Resource 处理器

提供基础资源访问功能，支持：

列出可用资源
读取资源内容

配置说明

环境变量

PHP_MEMORY_LIMIT: PHP 内存限制 (默认: 1G)
PHP_TIMEZONE: 时区设置 (默认: PRC)

日志配置

日志文件位于 runtime/server_log.txt，可通过 LoggerService 配置：

LoggerService::createLogger(
    'php-mcp-server',
    BASE_PATH . '/runtime/server_log.txt',
    false
);

开发

代码规范

项目使用 PHP_CodeSniffer 进行代码规范检查：

./vendor/bin/phpcs

静态分析

使用 PHPStan 进行静态代码分析：

composer analyse

测试

运行单元测试：

./vendor/bin/phpunit

PHP MCP Server: Effortless Scalability & Snappy Performance