How to Build an MCP Server Quickly with the Webman Plugin

Overview

Provides a Webman plugin based on the Model Context Protocol (MCP) SDK for quickly creating an MCP server.

Features

🚀 Fast startup, supports multiple transport protocols

🛠️ Command‑line tool to generate components

📡 Supports stdio, HTTP, SSE transports

🔧 Built‑in utilities, prompts, and resource management

Installation

composer require x2nx/webman-mcp

Quick Start

# Start stdio mode
php mcp-stdio.php

# Production mode (HTTP)
php webman start

# Test connection
curl -X POST http://127.0.0.1:7190/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "initialize", "params": {}}'

Create Components

# Create tool
php webman make:mcp-tool UserManager --name=get_user_info --description="获取用户信息"

# Create prompt
php webman make:mcp-prompt CodeReview --name=code_review --description="代码审查提示"

# Create resource
php webman make:mcp-resource ConfigResource --name=get_config --description="获取配置信息"

# Create resource template
php webman make:mcp-template ConfigResourceTemplate --name=get_config --description="获取配置信息"

Configuration

Edit config/plugin/x2nx/webman-mcp/mcp.php to set server name, version, description, and discovery options such as base_path, scan_dirs, and exclude_dirs.

<?php
return [
    'server' => [
        'name' => 'My MCP Server',
        'version' => '1.0.0',
        'description' => '自定义 MCP 服务器',
        'discover' => [
            'base_path' => base_path(),
            'scan_dirs' => ['app/mcp'],
            'exclude_dirs' => ['vendor', 'runtime'],
        ],
    ],
];

Deployment

# Production environment
php webman start -d

Running Screenshots