ThinkPHP Boost：为 ThinkPHP 8.x 量身打造的 AI 辅助开发与 PHP LSP 工具集

你是否在 ThinkPHP 开发中希望获得更智能的编码辅助？ThinkPHP Boost 正是为此而生。它是一个基于 MCP 协议的 AI 辅助开发工具包，专为 ThinkPHP 框架生态设计，旨在通过一系列自动化工具和智能指导规则，显著提升开发者的编码效率与代码规范性。

项目简介

ThinkPHP Boost 内置了十余个开箱即用的专业工具，可以无缝集成到 Cursor、Claude Code 等支持 MCP 的 AI 代理中，简化你的 AI 辅助编码工作流。更重要的是，它包含了一套为 ThinkPHP 精心制作的可组合 AI 指导规则，确保 AI 生成的代码不仅功能正确，而且严格符合 ThinkPHP 的框架规范与最佳实践。

项目地址：https://github.com/yangweijie/think-boost

安装与快速开始

通过 Composer 可以轻松安装 ThinkPHP Boost：

composer require yangweijie/think-boost --dev

安装完成后，只需执行一个命令即可完成 MCP 服务器和 AI 指导规则的安装：

php think boost:install

至此，你就可以在你喜欢的 AI 编码工具中开始享受 ThinkPHP 专属的智能辅助了。

核心功能一览

丰富的 MCP 工具集

ThinkPHP Boost 提供了一系列直接操作项目环境的工具，让 AI 能更好地“理解”你的代码上下文。

名称	说明
Application Info	读取 PHP 和 ThinkPHP 版本、数据库引擎、已安装扩展包及模型列表
Database Connections	检查项目配置的可用数据库连接
Database Query	对数据库执行查询
Database Schema	读取数据库表结构
Get Config	使用点符号从配置文件中获取指定值
Last Error	从应用日志文件中读取最近的错误信息
List Routes	查看应用程序中定义的所有路由
Browser Logs	读取浏览器端的日志与错误信息

强大的 PHP LSP 支持

除了基础的 MCP 工具，ThinkPHP Boost 还集成了完整的 PHP 语言服务器协议支持，将现代 IDE 级别的代码分析能力带到了命令行和 AI 协作环境中。

工具	核心功能
PhpLsp	代码分析、语法检查、符号查找、跳转定义、引用查找
StaticAnalysis	静态代码分析、代码质量检查、安全漏洞扫描、性能分析
SymbolIndex	符号索引构建、类层次结构分析、实现查找、文件大纲生成
CodeCompletion	智能代码补全、上下文感知建议、框架特定代码片段
CodeFormatter	代码自动格式化、支持 PSR 标准与 ThinkPHP 编码规范

内置的 AI 指导规则

为了让 AI 生成的代码更“地道”，ThinkPHP Boost 预置了针对以下核心领域的指导规则：

• ThinkPHP 核心 (支持 8.x 及通用版)
• 数据库操作 (通用版)
• 测试指南 (通用版)

core 指导规则提供了该领域通用、广泛适用的编码建议，不依赖特定版本。

进阶使用与配置

添加自定义 AI 指导规则

如果你想引入自己或团队的编码规范，可以轻松扩展。只需将编写好的 .md 格式的指导规则文件，放入项目的 .ai/ 目录中。下次运行 boost:install 命令时，这些自定义规则会自动被加载。

手动配置 MCP 服务器

在某些编辑器或环境中，可能需要手动注册 MCP 服务器。你可以使用以下配置信息进行注册：

项	值
Command	php
Args	think boost:mcp

对应的 JSON 配置示例：

{
    "mcpServers": {
        "thinkphp-boost": {
            "command": "php",
            "args": ["think", "boost:mcp"]
        }
    }
}

个性化配置

通过修改 config/boost.php 配置文件，你可以自定义工具包的行为：

<?php
return [
    // 总开关
    'enabled' => env('boost.enabled', true),

    // 是否启用浏览器日志监听
    'browser_logs_watcher' => env('boost.browser_logs_watcher', true),

    // MCP 工具配置
    'mcp' => [
        'tools' => [
            'exclude' => [], // 需要排除的工具类
            'include' => [], // 额外包含的自定义工具类
        ],
    ],
];

PHP LSP 工具使用示例

这些强大的代码分析工具可以直接通过命令行调用：

# 1. 语法检查
php think boost:tool PhpLsp '{"action":"syntax_check","file_path":"app/controller/Index.php"}'

# 2. 获取代码补全建议
php think boost:tool CodeCompletion '{"content":"<?php $user->","line":0,"character":13}'

# 3. 执行静态代码分析
php think boost:tool StaticAnalysis '{"target":"app/controller","analysis_type":"all"}'

# 4. 构建符号索引
php think boost:tool SymbolIndex '{"action":"build_index","include_vendor":false}'

# 5. 格式化代码
php think boost:tool CodeFormatter '{"content":"<?php class Test{function test(){return true;}}","style":"psr12"}'

可用命令总结

• php think boost:install - 安装 Boost MCP 服务器与所有 AI 指导规则。
• php think boost:mcp - 启动 MCP 服务器进程。
• php think boost:tool <工具名> [参数] - 直接调用执行某个特定的 MCP 工具。

面向开发者：如何贡献新工具

如果你有好的工具创意，可以轻松地为 ThinkPHP Boost 扩展新功能。

创建新工具类

在 src/mcp/tools/ 目录下创建一个新的 PHP 类即可。以下是一个模板示例：

<?php

namespace think\boost\mcp\tools;

use Laravel\Mcp\Server\Tool;
use Laravel\Mcp\Server\Tools\Annotations\IsReadOnly;
use Laravel\Mcp\Server\Tools\ToolInputSchema;
use Laravel\Mcp\Server\Tools\ToolResult;

#[IsReadOnly]
class MyTool extends Tool
{
    public function description(): string
    {
        return 'My custom tool description';
    }

    public function schema(ToolInputSchema $schema): ToolInputSchema
    {
        return $schema->string('param')->required();
    }

    public function handle(array $arguments): ToolResult
    {
        return ToolResult::json(['result' => 'success']);
    }
}

运行测试

为保证代码质量，在提交贡献前请运行测试套件：

composer test

结语

ThinkPHP Boost 巧妙地将 MCP 协议、AI 指导规则与 PHP LSP 的强大分析能力结合在一起，为 PHP 开发者，特别是 ThinkPHP 用户，提供了一个提升开发体验与代码质量的得力助手。无论是想提高 AI 结对编程的效率，还是希望获得更专业的代码审查能力，它都值得一试。

如果你对这类提升 ThinkPHP 开发效率的工具有兴趣，或者有自己的使用心得，欢迎到 云栈社区 的对应板块分享与交流。