面向人类与 AI 的统一 Laravel API 层

单一代码库。面向人类的 REST，面向 AI Agent 的 MCP。

Laravel Restify 能自动将你的 Eloquent 模型转化为 JSON:API 端点和 MCP（Model Context Protocol）服务器。只需构建一次，即可即时提供同时适配开发者、应用程序和 AI Agent 的 API。

🚀 单一代码库的威力

传统的 API 开发需要为不同的使用者编写不同的实现。Laravel Restify 改变了这一点：

• 👥 人类：获得功能齐全的 JSON:API 端点
• 🤖 AI Agents：获得结构化的 MCP（Model Context Protocol）服务器
• 🔒 统一规则：所有的认证、授权和策略对两者同样适用
• 📝 单一定义：编写一次 Repository，到处使用

核心功能

• JSON:API 端点：完全符合 JSON:API 规范
• MCP 服务器生成：带工具定义的自动 AI Agent 接口
• 统一授权：使用 Laravel Policies 保护人类与 AI 的访问
• 搜索与过滤：为所有用户提供强大的查询能力
• 认证：集成 Laravel Sanctum 以确保安全访问
• GraphQL 支持：自动生成 GraphQL Schema
• 字段验证：在所有接口中保持一致的验证规则

安装

composer require binaryk/laravel-restify

快速开始

1. 初始化包：

php artisan restify:setup

2. 创建你的第一个 Repository：

php artisan restify:repository PostRepository --all

3. 为 AI Agent 启用 MCP（可选）：

在你的 config/ai.php 中添加：

use Binaryk\LaravelRestify\MCP\RestifyServer;
use Laravel\Mcp\Facades\Mcp;

Mcp::web('restify', RestifyServer::class)
    ->middleware(['auth:sanctum'])
    ->name('mcp.restify');

搞定！ 你的 API 现在可以同时服务于：

面向人类 (JSON:API)：

GET /api/restify/posts
POST /api/restify/posts
PUT /api/restify/posts/1
DELETE /api/restify/posts/1

面向 AI Agents (MCP)：

GET /mcp/restify  # 工具定义与功能描述

示例 Repository

use Binaryk\LaravelRestify\Http\Requests\RestifyRequest;
use Binaryk\LaravelRestify\Repositories\Repository;
use Binaryk\LaravelRestify\Attributes\Model;

#[Model(Post::class)]
class PostRepository extends Repository
{
    public function fields(RestifyRequest $request): array
    {
        return [
            field('title')->rules('required', 'string', 'max:255'),
            textarea('content')->rules('required'),
            field('author')->readonly(),
            datetime('published_at')->nullable(),
        ];
    }
}

这单一的定义会自动提供：

• ✅ 带有验证的 JSON:API CRUD 端点
• ✅ 为 AI Agent 提供相同验证逻辑的 MCP 工具
• ✅ 适用于两个接口的授权策略
• ✅ 为所有使用者提供搜索和过滤能力

单一代码库，双重产出

以下是你通过单一 Repository 定义所获得的内容：

面向人类 (JSON:API 响应)

GET /api/restify/posts

{
  "data": [
    {
      "id": "1",
      "type": "posts",
      "attributes": {
        "title": "Laravel Restify 指南",
        "content": "快速构建 API...",
        "published_at": "2024-01-15"
      }
    }
  ],
  "links": {
    "self": "/api/restify/posts",
    "next": "/api/restify/posts?page=2"
  }
}

面向 AI Agents (MCP 工具定义)

GET /mcp/restify  # 供 AI Agent 使用的工具定义

{
  "tools": [
    {
      "name": "posts-index-tool",
      "description": "从 posts 仓库中检索分页后的 Post 记录列表，支持过滤、排序和搜索。",
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "number",
            "description": "分页页码"
          },
          "perPage": {
            "type": "number", 
            "description": "每页记录数"
          },
          "search": {
            "type": "string",
            "description": "按标题或内容过滤文章的搜索词"
          },
          "sort": {
            "type": "string",
            "description": "排序标准（例如 sort=title 或 sort=-published_at 表示降序）"
          },
          "title": {
            "type": "string",
            "description": "按标题精确匹配过滤（例如 title=Laravel）。支持取反，如 -title=value"
          },
          "published_at": {
            "type": "string",
            "description": "按发布日期过滤（例如 published_at=2024-01-15）"
          }
        }
      }
    }
  ]
}

所有这些都由这个简单的 Repository 自动生成：

#[Model(Post::class)]
class PostRepository extends Repository
{
    use HasMcpTools;
    
    public function fields(RestifyRequest $request): array
    {
        return [
            field('title')->required()->matchable(),
            field('