PHPackages                             luoyue/webman-mcp - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. luoyue/webman-mcp

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

luoyue/webman-mcp
=================

Webman plugin luoyue/webman-mcp

0.4.1(2mo ago)91982[6 issues](https://github.com/luoyue712/webman-mcp/issues)[2 PRs](https://github.com/luoyue712/webman-mcp/pulls)Apache-2.0PHPPHP &gt;=8.1CI failing

Since Nov 24Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/luoyue712/webman-mcp)[ Packagist](https://packagist.org/packages/luoyue/webman-mcp)[ RSS](/packages/luoyue-webman-mcp/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (23)Versions (15)Used By (0)

webman-mcp
==========

[](#webman-mcp)

[![Packagist Version](https://camo.githubusercontent.com/1c483ca8bc0a19dc2365c279fb6b7169a33be6030c5b09cddbe6734c6fc4a18c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c756f7975652f7765626d616e2d6d6370)](https://camo.githubusercontent.com/1c483ca8bc0a19dc2365c279fb6b7169a33be6030c5b09cddbe6734c6fc4a18c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c756f7975652f7765626d616e2d6d6370) [![Packagist License](https://camo.githubusercontent.com/db2b5f68db23cf11be6816cc7244ba554a8c79befb5fc92caf02d8022fd87e10/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c756f7975652f7765626d616e2d6d6370)](https://camo.githubusercontent.com/db2b5f68db23cf11be6816cc7244ba554a8c79befb5fc92caf02d8022fd87e10/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6c756f7975652f7765626d616e2d6d6370) [![PHP Version](https://camo.githubusercontent.com/3108f97fffbc62835358b7eddb8a086d2379a3db15a6571cdbc826f204ede6b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6c756f7975652f7765626d616e2d6d63702f706870)](https://camo.githubusercontent.com/3108f97fffbc62835358b7eddb8a086d2379a3db15a6571cdbc826f204ede6b3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6c756f7975652f7765626d616e2d6d63702f706870) [![SDK Version](https://camo.githubusercontent.com/3c1a9384f1840ac51c73d511fe4ae804223ca06368879ab4bf19a6fea0755834/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6c756f7975652f7765626d616e2d6d63702f6d637025324673646b3f6c6162656c3d73646b)](https://camo.githubusercontent.com/3c1a9384f1840ac51c73d511fe4ae804223ca06368879ab4bf19a6fea0755834/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646570656e64656e63792d762f6c756f7975652f7765626d616e2d6d63702f6d637025324673646b3f6c6162656c3d73646b) [![MCP](https://camo.githubusercontent.com/ded00504534d681a54c557470bd45cc57e5406c46596b1e8110a8b120fc9e5a2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4d43502d4d6f64656c253230436f6e7465787425323050726f746f636f6c2d707572706c65)](https://modelcontextprotocol.io/) [![Packagist Downloads](https://camo.githubusercontent.com/de4603a6c5940c5dc2a63cc29fbc41869f54e57ed4c7d6078f45b9f9d738203d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c756f7975652f7765626d616e2d6d6370)](https://camo.githubusercontent.com/de4603a6c5940c5dc2a63cc29fbc41869f54e57ed4c7d6078f45b9f9d738203d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c756f7975652f7765626d616e2d6d6370) [![Packagist Stars](https://camo.githubusercontent.com/45ee73eafee8ee5fa15c4db827f7d88a92dd268f21c4595349acde5e23759ff2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f6c756f7975652f7765626d616e2d6d6370)](https://camo.githubusercontent.com/45ee73eafee8ee5fa15c4db827f7d88a92dd268f21c4595349acde5e23759ff2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f6c756f7975652f7765626d616e2d6d6370)

这是一个Webman框架与官方MCP PHP SDK深度集成的插件，并在SDK基础上进行了扩展，可快速创建MCP服务器。

> 此插件依赖于官方的[MCP PHP SDK](https://github.com/modelcontextprotocol/php-sdk)，以下文档仅展示插件与sdk的差异。

特性
--

[](#特性)

- 一键启动，安装后即可启动，同时支持配置复杂的功能。
- 一个项目支持多个MCP服务器，并按服务器名称隔离配置。
- 与Webman框架深度集成，HTTP支持路由模式和自定义进程模式。
- 自动注册MCP服务到主流IDE（VSCode、Cursor、通义灵码等）。
- 支持 STDIO、Streamable HTTP 高性能传输。
- 支持协程与非协程，从而提高了在sse场景下高性能传输。
- 内置常用20+个MCP开发工具，提升开发效率。

安装
--

[](#安装)

```
composer require luoyue/webman-mcp
```

### 环境要求

[](#环境要求)

- PHP &gt;= 8.1
- webman^2.1
- webman/cache^2.1

### 可选依赖

[](#可选依赖)

- webman/redis
- webman/event（用于MCP生命周期钩子）
- Swoole/Swow/Fiber协程（提升SSE性能）
- monolog/monolog（用于记录服务器日志）

注解
--

[](#注解)

注解名称描述McpTool标记一个PHP方法为MCP工具，使其可以被AI调用执行特定功能McpPrompt标记一个PHP方法为MCP提示生成器，用于生成对话提示消息McpResource标记一个PHP方法为MCP资源处理器，用于处理特定资源URI的请求McpResourceTemplate标记一个PHP方法为MCP资源模板，用于定义资源URI模板CompletionProvider为参数提供自动完成功能，指定可能的值或提供者类Schema定义方法或参数的JSON Schema，用于参数验证和类型检查启动方式
----

[](#启动方式)

```
# 启动 MCP STDIO 服务器, mcp为服务器名称，配置文件中定义
php webman mcp:server mcp

# 启动 MCP HTTP 服务器(分为两种，一种是嵌入到路由中，另一种是自定义进程)
php webman start
```

快速开始
----

[](#快速开始)

### 1. 使用命令行工具创建模板代码（也可直接使用插件自带的配置）

[](#1-使用命令行工具创建模板代码也可直接使用插件自带的配置)

```
# 创建文件后可根据模板代码实现逻辑
php webman mcp:make template
```

实际上并不太需要此命令创建代码，因为使用方法已足够简单，只需在方法中声明注解即可。

### 2. 配置客户端连接配置

[](#2-配置客户端连接配置)

打开app.php，修改`auto_register_client`配置为您常用的客户端。

```
