1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | Php Mcp Server Generator Github Awesome Copilot | — |
| 作者/维护者 | github/awesome-copilot 社区贡献者(仓库由 GitHub 官方维护) | GitHub API |
| 来源链接 | https://github.com/github/awesome-copilot/tree/main/skills/php-mcp-server-generator | — |
| 许可证 | MIT(仓库级) | GitHub API |
| GitHub Stars | 合集仓库整体 38,918 stars;该数字属整个合集,不代表本技能自身热度 | GitHub API |
| Forks | 合集仓库整体约 4,900+ | GitHub API |
| 最新版本 | 无独立版本号;文件内容自 2026-02-19 起未见针对性更新提交 | GitHub API(commit 历史) |
| 安装方式 | gh skills install github/awesome-copilot php-mcp-server-generator(需 GitHub CLI ≥ v2.90.0),或手动复制技能文件夹 |
仓库文档 |
2. 功能介绍与亮点
该技能指导 Agent 在 PHP 生态下生成一个完整、生产可用的 Model Context Protocol(MCP)服务器项目:
- 官方 SDK 为基础:基于 modelcontextprotocol 官方 PHP SDK(
php-sdk),采用 PHP 8.2+ 的 Attribute 语法(#[McpTool]、#[McpResource]、#[McpResourceTemplate])声明工具与资源,无需手写协议层样板代码。 - 交互式收集需求:技能开工时先向用户询问项目名、描述、传输方式(stdio/HTTP/两者)、需要的工具清单、是否包含 Resources 与 Prompts、PHP 版本,再据此生成定制化项目。
- 覆盖完整功能面:不仅生成基础工具,还给出带 Schema 校验的输入(如邮箱格式校验)、枚举类型工具、静态资源与动态资源模板(URI 模板)三类进阶示例,以及 PHPUnit 测试骨架。
- 交付即可运行:附完整的
composer install/vendor/bin/phpunit/php server.php运行命令,并给出用@modelcontextprotocol/inspector联调、以及 Claude DesktopmcpServers配置片段的完整示例。
主要亮点:内容覆盖“从需求收集到可运行服务器”全过程,示例代码同时演示了输入校验、枚举类型与静态/动态资源三类进阶用法,比单纯的“Hello World”级模板更完整。
3. 适用场景
所属分类:集成与工作流自动化。
该技能面向需要用 PHP 技术栈为项目快速搭建符合规范的 MCP 服务器的开发者,典型场景包括:
- 把现有 PHP 后端(Laravel/Symfony 等框架之外的独立服务,或轻量脚本)里的业务逻辑、数据源封装成 MCP 工具,供 Claude Code / Codex 等 Agent 调用
- 需要一个开箱即用、附带输入校验与测试示范的 MCP 服务器起点项目,而非从零查阅协议规范手写样板代码
- 学习 MCP 协议在 PHP 官方 SDK 下的标准实现方式(Attribute 声明式工具、Schema 校验、Resource/Prompt 组件)
PHP 是当前 Web 后端领域使用人数最庞大的语言之一,初中级 PHP 开发者尤其受益:技能把工具/资源/Prompt 的样板代码、测试脚手架与 Claude Desktop 接入方式直接固化成可执行模板,省去自行翻查官方 SDK 文档与协议规范的成本。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md(YAML frontmatter + Markdown 正文),符合 Agent Skills 通用规范,技能本体不联网、不执行代码 |
| Codex | 原生支持 | 纯文本参考技能,核心生成阶段(写文件)不涉及联网或系统调用,不受沙箱断网限制;仅当用户额外执行 composer install 或联网测试时才需要网络 |
| OpenClaw | 未验证 | 未找到该平台的直接安装记录,但技能本身不含平台专有语法,理论上可直接迁移 |
| Hermes Agent | 未验证 | 同上,未找到具体验证来源 |
5. 推荐理由
手写一个符合 MCP 规范的 PHP 服务器,需要同时处理 Attribute 声明式协议映射、Schema 校验、传输层选择与测试骨架等多项工程决策;该技能把这些决策固化成一份可直接生成的完整项目模板,交付的是一个装依赖后即可运行的项目而非玩具示例。PHP 是 Web 后端领域覆盖人数最广的语言之一,对初中级 PHP 开发者而言,这份模板省去了自行翻查协议规范与 SDK 文档的门槛。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 GitHub 为公认一线技术厂商,官方权威背书;合集仓库 38,918 stars 属整个合集不代表本技能个体热度,该子技能自身未见独立第三方讨论 |
| 可用性 | 6 | 一次对话即可生成完整项目,composer install 后一条命令构建运行,文档含进阶示例(Schema 校验、枚举、动态资源)与测试骨架;但文件自 2026-02-19 创建以来未见任何针对性更新提交(超过 6 个月),维护活跃度判定为一般 |
| 安全性 | 9 | 纯提示词/模板类技能,不执行任何代码、不联网、不涉及凭据;仓库 License 明确(MIT);正文通读一遍未见可疑指令或与任务无关的品牌植入 |
综合评分:7.33
安全检查清单:① 无 shell 命令执行(仅指导生成的项目自身含标准 composer/phpunit 等命令,不由技能本体执行)② 无运行时联网外发 ③ 不涉及 API key/凭据 ④ 正文未发现任何可疑指令或 prompt injection 迹象 ⑤ 作者为 GitHub 官方仓库贡献者,信誉良好 ⑥ License 明确(MIT)⑦ 文件自创建以来无针对性维护提交,非弃置项目但活跃度一般。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| typescript / java / ruby / rust / python / go / dotnet-mcp-builder(同仓库) | 分别生成对应语言的 MCP 服务器项目模板 | 面向不同语言技术栈;均为一次性生成的项目脚手架,本技能是其中面向 PHP 生态的版本 |
| kotlin-mcp-server-generator(同仓库) | 生成 Kotlin 版 MCP 服务器 | 面向 JVM/Android 技术栈;官方 SDK 活跃度(1,450★,近 2 日内更新)与本技能相近,但 PHP 的 Web 后端开发者基数更大,受众更广泛 |
| swift-mcp-server-generator(同仓库) | 生成 Swift 版 MCP 服务器 | 面向 Apple 生态;对应官方 Swift SDK 已约 4 个月无新提交,生态活跃度低于本技能依赖的 PHP SDK |
| mcp-copilot-studio-server-generator(同仓库) | 生成面向 Microsoft Copilot Studio / Power Platform 的 MCP 连接器 | 定位是特定厂商平台的连接器生成,需要 Power Platform/Copilot Studio 账号与环境,受众明显窄于面向通用 PHP 开发者的本技能 |
| mcp-builder(Anthropic 官方) | 通用 MCP 服务器构建指南,不锚定具体语言栈 | 定位更宏观,覆盖多语言但工程细节较浅;本技能专注 PHP 一个技术栈,把 Attribute 声明、Schema 校验、测试等细节讲透 |
本技能与仓库内其他语言版本的核心差异在于:PHP 作为 Web 后端领域使用人数最庞大的语言之一,面向的初中级开发者群体比 Kotlin(JVM/Android)、Swift(Apple 生态)等更专项的技术栈更广泛,且不像 mcp-copilot-studio-server-generator 那样需要企业级平台账号。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。检索到该技能已被多个第三方 Skill 聚合/镜像站点收录并展示,但均为自动化收录展示,不构成具名用户评价。
9. 其他补充
技能正文为纯英文;仓库支持通过 gh skills install 一次性拉取,也可手动复制 skills/php-mcp-server-generator/SKILL.md 到本地 Agent 的技能目录。
10. 安装使用方式
方式一(推荐):安装 GitHub CLI v2.90.0 及以上版本后执行:
gh skills install github/awesome-copilot php-mcp-server-generator
方式二:手动下载 https://github.com/github/awesome-copilot/tree/main/skills/php-mcp-server-generator 目录下的 SKILL.md,放入你的 Agent 技能目录(如 Claude Code 的 .claude/skills/)。
安装后无需重启,Agent 会在识别到“生成 PHP MCP 服务器”相关请求时自动加载该技能;技能本身不含可执行脚本,仅提供指令模板,生成出的项目需要本地安装 PHP 8.2 及以上版本、Composer 才能构建运行。
11. 注意事项
- 技能正文假定使用者已了解 PHP 基础工程实践(Composer 依赖管理、Attribute 语法、PSR 编码规范);对完全没有 PHP 经验的用户仍需额外学习成本。
- 文件内容自 2026-02-19 起未见针对性更新提交,若官方 PHP SDK 后续出现破坏性升级(如 Attribute 语法变化),模板中的代码片段可能需要使用者自行核对最新官方文档。
- 该技能与仓库内其他语言版本的 MCP 服务器生成技能功能定位相近但技术栈互斥,按需选择对应语言版本。