test(mcp): MCP 端点、CSRF 豁免与回归全量测试

tests/router.php

@@ -0,0 +1,51 @@
+<?php
+/**
+ * MCP e2e 专用 HTTP 入口（php -S 路由脚本，仅测试使用，绝不能被生产引用）.
+ *
+ * 用法（容器内，由 tests/McpEndpointTest::setUpBeforeClass 自动拉起）：
+ *   PHP_CLI_SERVER_WORKERS=4 php -S 127.0.0.1:8127 -t public tests/router.php
+ *
+ * 文件名必须是 router.php（关键约束）：
+ *   php -S + 路由脚本时 $_SERVER['SCRIPT_FILENAME'] 指向本文件，
+ *   think-multi-app 的 MultiApp::getScriptName() 用它的文件名做「入口绑定应用」
+ *   判定——白名单仅 ['index','router','think'] 豁免；叫别的名字（如 e2e_server）
+ *   会被当成应用名绑定，pathinfo 首段不再做应用识别，/admin/* 全部 404。
+ *
+ * 为什么不用容器 nginx（127.0.0.1:8000）：
+ *   nginx/fpm 栈读 .env 指向开发库（ulthon），而 e2e 断言要求 fixture 自包含
+ *   且严格落在测试库（ulthon_test，ulthon-testing 技能铁律 + 任务 MUST NOT）。
+ *   事务内的 fixture 对独立 HTTP 连接永远不可见，因此 e2e 只能：
+ *   a) 把 fixture 提交进开发库（违反测试库/开发库分离，禁止）；或
+ *   b) 起一个与 PHPUnit 同样做 config 级测试库覆盖的独立 HTTP 服务（本方案）。
+ *   本入口与 tests/bootstrap.php 共享同一套覆盖逻辑（require 复用，防漂移），
+ *   走完整 HTTP 内核（多应用路由 / 中间件 / Session），是真实 HTTP 栈 e2e。
+ *
+ * 测试专用请求头（生产代码零改动的注入点）：
+ *   X-E2E-Mcp-Disabled: 1 -> config mcp.enable=false（覆盖 403 分支；
+ *   mcp.enable 在控制器内经 config() 读取，e2e 期望它默认 true，
+ *   又不能从 PHPUnit 进程改另一个进程的 Config，故由本入口代劳）。
+ *
+ * 自请求并发说明：tools/call 分发会从本服务回环 POST /admin/*（McpDispatchBase），
+ * php -S 默认单 worker 会死锁，必须 PHP_CLI_SERVER_WORKERS>1（Linux，PHP>=7.4）。
+ */
+
+declare(strict_types=1);
+
+// 复用 PHPUnit 引导：autoload + App 初始化 + config 级覆盖到测试库 + 非 test 库护栏。
+// bootstrap.php 是无 PHPUnit 依赖的纯脚本（抛 RuntimeException 拒绝非测试库），
+// 这里 require 后 $app 即已就绪的容器实例。
+require __DIR__ . '/bootstrap.php';
+
+// 403 分支模拟（仅测试头，见文件头注释）
+if (($_SERVER['HTTP_X_E2E_MCP_DISABLED'] ?? '') === '1') {
+    \think\facade\Config::set(['enable' => false], 'mcp');
+}
+
+// 标准 HTTP 内核（与 public/index.php 同构；initialize 幂等，config 覆盖不会被冲掉）
+$http = $app->http;
+
+$response = $http->run();
+
+$response->send();
+
+$http->end($response);