PHPackages                             x2nx/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. x2nx/webman-mcp

ActiveLibrary

x2nx/webman-mcp
===============

webman-mcp service based on Mcp/sdk

v0.1.3.1(5mo ago)131434MITPHP

Since Sep 29Pushed 5mo agoCompare

[ Source](https://github.com/x2nx/webman-mcp)[ Packagist](https://packagist.org/packages/x2nx/webman-mcp)[ Docs](https://github.com/x2nx/webman-mcp)[ RSS](/packages/x2nx-webman-mcp/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (8)Versions (20)Used By (0)

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

[](#webman-mcp)

[![webman-mcp](https://camo.githubusercontent.com/e4f0bdc1219528d4044787c6e1577e1fd457246b3f0dccf61d5051af545d51d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7765626d616e2d6d63702d626c75653f7374796c653d666f722d7468652d6261646765266c6f676f3d706870)](https://camo.githubusercontent.com/e4f0bdc1219528d4044787c6e1577e1fd457246b3f0dccf61d5051af545d51d5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7765626d616e2d6d63702d626c75653f7374796c653d666f722d7468652d6261646765266c6f676f3d706870)[![PHP](https://camo.githubusercontent.com/6795af0ba17c14a3fca23514cd5b8df834cc6460a5f0c8a8c2d6cb0bfabd553e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312b2d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/6795af0ba17c14a3fca23514cd5b8df834cc6460a5f0c8a8c2d6cb0bfabd553e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312b2d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870266c6f676f436f6c6f723d7768697465)[![License](https://camo.githubusercontent.com/153acf9dff19deb8abfc598c53bac50a4ceae0f5c83a552711060d3d78d2c057/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e3f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/153acf9dff19deb8abfc598c53bac50a4ceae0f5c83a552711060d3d78d2c057/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e3f7374796c653d666f722d7468652d6261646765)[![Version](https://camo.githubusercontent.com/4f907efc71bbb5cc9bd2a0a582f8c0c0f7558cba0495b43aa31e05fa99cda290/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d302e312e332d6f72616e67653f7374796c653d666f722d7468652d6261646765)](https://camo.githubusercontent.com/4f907efc71bbb5cc9bd2a0a582f8c0c0f7558cba0495b43aa31e05fa99cda290/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d302e312e332d6f72616e67653f7374796c653d666f722d7468652d6261646765)

**基于 MCP (Model Context Protocol) SDK 的 webman 插件，快速创建高性能 MCP 服务器**

[快速开始](#-%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B) • [创建组件](#%EF%B8%8F-%E5%88%9B%E5%BB%BA%E7%BB%84%E4%BB%B6) • [消息处理](#-%E6%B6%88%E6%81%AF%E5%A4%84%E7%90%86) • [配置说明](#%EF%B8%8F-%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E) • [常见问题](#-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98)

✨ 核心特性
------

[](#-核心特性)

- 🚀 **快速启动** - 支持多种传输协议，开箱即用
- 🛠️ **命令行工具** - 快速生成 MCP 组件，提升开发效率
- 📡 **多协议支持** - 支持 stdio、HTTP、SSE 传输模式
- 💬 **消息处理** - 提供便捷的消息传输处理和全局辅助函数
- 🔧 **组件管理** - 内置工具、提示和资源管理系统
- ⚡ **高性能** - 基于 webman 框架，支持高并发处理
- 🎯 **易于扩展** - 灵活的配置系统，支持自定义扩展

📦 安装
----

[](#-安装)

### 环境要求

[](#环境要求)

- PHP >= 8.1
- Composer
- webman 框架

### 安装步骤

[](#安装步骤)

```
# 安装插件
composer require x2nx/webman-mcp
```

🚀 快速开始
------

[](#-快速开始)

### 1. 启动服务

[](#1-启动服务)

```
# 开发模式 - stdio
php mcp-stdio.php

# 生产模式 - HTTP/SSE
php webman start
```

### 2. 测试连接

[](#2-测试连接)

#### HTTP 流式传输测试

[](#http-流式传输测试)

```
# 测试 MCP 连接
curl -vvv -X POST http://127.0.0.1:7190/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json,text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": "test-001",
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {
        "elicitation": {}
      },
      "clientInfo": {
        "name": "example-client",
        "version": "1.0.0"
      }
    }
  }'
```

#### SSE 模式测试

[](#sse-模式测试)

```
# 1. 建立 SSE 连接（获取 sessionId）
curl -N -H "Accept: text/event-stream" http://127.0.0.1:7190/sse

# 2. 发送消息（使用上一步获取的 sessionId）
curl -X POST "http://127.0.0.1:7190/message?sessionId=YOUR_SESSION_ID" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":"1","method":"tools/list"}'
```

🛠️ 创建组件
-------

[](#️-创建组件)

webman-mcp 提供了强大的命令行工具，帮助您快速创建各种 MCP 组件。

### 创建工具 (Tools)

[](#创建工具-tools)

```
# 创建用户管理工具
php webman make:mcp-tool UserManager \
  --name=get_user_info \
  --description="获取用户详细信息"

# 创建文件操作工具
php webman make:mcp-tool FileManager \
  --name=read_file \
  --description="读取文件内容"
```

### 创建提示 (Prompts)

[](#创建提示-prompts)

```
# 创建代码审查提示
php webman make:mcp-prompt CodeReview \
  --name=code_review \
  --description="代码质量审查和优化建议"

# 创建文档生成提示
php webman make:mcp-prompt DocGenerator \
  --name=generate_docs \
  --description="自动生成API文档"
```

### 创建资源 (Resources)

[](#创建资源-resources)

```
# 创建配置资源
php webman make:mcp-resource ConfigResource \
  --name=get_config \
  --description="获取系统配置信息"

# 创建数据库资源
php webman make:mcp-resource DatabaseResource \
  --name=query_db \
  --description="执行数据库查询"
```

### 创建资源模板 (Resource Templates)

[](#创建资源模板-resource-templates)

```
# 创建配置模板
php webman make:mcp-template ConfigResourceTemplate \
  --name=get_config \
  --description="获取配置信息模板"

# 创建API模板
php webman make:mcp-template ApiResourceTemplate \
  --name=api_docs \
  --description="API文档模板"
```

> 💡 **提示**: 创建组件后，重启服务即可自动发现新组件

💬 消息处理
------

[](#-消息处理)

webman-mcp 提供了灵活的消息处理机制，支持在代码中直接处理 MCP 消息。

### 全局辅助函数

[](#全局辅助函数)

插件提供了两个全局辅助函数，方便在项目任何地方使用：

#### `mcp_server_handle_message()` - 处理消息

[](#mcp_server_handle_message---处理消息)

```