feat(router): update MCP routes to support multiple HTTP methods and improve handler retrieval

Author: lihq1403

README.md

@@ -32,14 +32,38 @@ If you're using Hyperf framework, integration is extremely simple:
 
 ```php
 // Just one line of code!
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```
 
+**Annotation-Based Registration**:
+```php
+class CalculatorService
+{
+    #[McpTool(description: 'Mathematical calculations')]
+    public function calculate(string $operation, int $a, int $b): array
+    {
+        return ['result' => match($operation) {
+            'add' => $a + $b,
+            'multiply' => $a * $b,
+            default => 0
+        }];
+    }
+    
+    #[McpResource(description: 'System information')]
+    public function systemInfo(): TextResourceContents
+    {
+        return new TextResourceContents('mcp://system/info', 
+            json_encode(['php' => PHP_VERSION]), 'application/json');
+    }
+}
+```
+
 **Advanced Options**:
 - 🔐 **AuthenticatorInterface** - Custom authentication
 - 📊 **HttpTransportAuthenticatedEvent** - Dynamic tool/resource registration
+- 📝 **Annotation System** - Auto-register tools, resources and prompts
 
 👉 [View Complete Hyperf Integration Guide](./docs/en/server/hyperf-integration.md)
 

README_CN.md

@@ -32,14 +32,38 @@ composer require dtyq/php-mcp
 
 ```php
 // 只需一行代码！
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```
 
+**基于注解的注册**：
+```php
+class CalculatorService
+{
+    #[McpTool(description: '数学计算')]
+    public function calculate(string $operation, int $a, int $b): array
+    {
+        return ['result' => match($operation) {
+            'add' => $a + $b,
+            'multiply' => $a * $b,
+            default => 0
+        }];
+    }
+    
+    #[McpResource(description: '系统信息')]
+    public function systemInfo(): TextResourceContents
+    {
+        return new TextResourceContents('mcp://system/info', 
+            json_encode(['php' => PHP_VERSION]), 'application/json');
+    }
+}
+```
+
 **高级选项**：
 - 🔐 **AuthenticatorInterface** - 自定义认证
 - 📊 **HttpTransportAuthenticatedEvent** - 动态工具/资源注册
+- 📝 **注解系统** - 自动注册工具、资源和提示
 
 👉 [查看完整 Hyperf 集成指南](./docs/cn/server/hyperf-integration.md)
 

docs/cn/server/hyperf-integration.md

@@ -19,8 +19,8 @@ composer require dtyq/php-mcp
 use Hyperf\HttpServer\Router\Router;
 use Dtyq\PhpMcp\Server\Framework\Hyperf\HyperfMcpServer;
 
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```
 
@@ -274,18 +274,18 @@ public function processUser(
 
 ```php
 // 只注册数学相关工具
-Router::post('/mcp/math', function () {
-    return di(HyperfMcpServer::class)->handler('math');
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp/math', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler('math');
 });
 
 // 注册开发工具
-Router::post('/mcp/dev', function () {
-    return di(HyperfMcpServer::class)->handler('development');
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp/dev', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler('development');
 });
 
 // 注册所有工具（默认分组）
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```
 
@@ -622,8 +622,8 @@ use Hyperf\HttpServer\Router\Router;
 use Dtyq\PhpMcp\Server\Framework\Hyperf\HyperfMcpServer;
 
 // MCP 服务端点 - 只需一行代码！
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```
 

docs/en/server/hyperf-integration.md

@@ -19,8 +19,8 @@ Add MCP route in your route file (e.g., `config/routes.php`):
 use Hyperf\HttpServer\Router\Router;
 use Dtyq\PhpMcp\Server\Framework\Hyperf\HyperfMcpServer;
 
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```
 
@@ -174,7 +174,7 @@ class SystemService
 
         return new TextResourceContents(
             'mcp://system/info',
-            json_encode($info, JSON_PRETTY_PRINT),
+            json_encode($info, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE),
             'application/json'
         );
     }
@@ -195,7 +195,7 @@ class SystemService
 
         return new TextResourceContents(
             'mcp://system/config',
-            json_encode($config, JSON_PRETTY_PRINT),
+            json_encode($config, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE),
             'application/json'
         );
     }
@@ -274,18 +274,18 @@ You can organize your annotations using groups and load specific groups:
 
 ```php
 // Register only math-related tools
-Router::post('/mcp/math', function () {
-    return di(HyperfMcpServer::class)->handler('math');
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp/math', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler('math');
 });
 
 // Register development tools
-Router::post('/mcp/dev', function () {
-    return di(HyperfMcpServer::class)->handler('development');
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp/dev', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler('development');
 });
 
 // Register all tools (default group)
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```
 
@@ -341,7 +341,7 @@ class McpDemoService
 
         return new TextResourceContents(
             'mcp://server/status',
-            json_encode($status, JSON_PRETTY_PRINT),
+            json_encode($status, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE),
             'application/json'
         );
     }
@@ -622,8 +622,8 @@ use Hyperf\HttpServer\Router\Router;
 use Dtyq\PhpMcp\Server\Framework\Hyperf\HyperfMcpServer;
 
 // MCP server endpoint - just one line of code!
-Router::post('/mcp', function () {
-    return di(HyperfMcpServer::class)->handler();
+Router::addRoute(['POST', 'GET', 'DELETE'], '/mcp', function () {
+    return \Hyperf\Context\ApplicationContext::getContainer()->get(HyperfMcpServer::class)->handler();
 });
 ```