内容
# Filament MCP 服务器 - Laravel Loop

> [!IMPORTANT]
> 这是测试版本,尚未建议用于生产环境。
Filament MCP 服务器是 [Laravel Loop](https://github.com/kirschbaum-development/laravel-loop) 的扩展,它将您的 Filament 资源暴露为 MCP 服务器。这允许 AI 助手和 MCP 客户端与您的 Filament 资源交互,进行数据列表、查询和(可选)操作。
## 功能
将您的 Filament 资源暴露为 MCP 工具。有 4 种工具可用:
- `list_filament_resources`:向 MCP 客户端列出所有可用的 Filament 资源。
- `describe_filament_resource`:描述给定资源的架构、字段、列、筛选器和关系。
- `get_filament_resource_data`:查询资源的數據,可选应用筛选器。
- `execute_filament_resource_action`:执行资源的大批量操作(仅在读写模式下)。
## 安装
1. 确保您已安装并配置 Laravel Loop。
2. 安装软件包:
```bash
composer require kirschbaum-development/laravel-loop-filament
```
3. 在您的应用程序中注册 Filament 工具包。通常在服务提供者中完成(例如,AppServiceProvider):
```php
use Kirschbaum\Loop\Loop;
use Kirschbaum\Loop\Filament\FilamentToolkit;
Loop::toolkit(FilamentToolkit::make());
```
默认情况下,它会暴露所有 Filament 资源。您可以通过 `resources` 参数控制哪些资源被暴露。
```php
use Kirschbaum\Loop\Loop;
use Kirschbaum\Loop\Filament\FilamentToolkit;
Loop::toolkit(FilamentToolkit::make(resources: [
\App\Filament\Resources\UserResource::class,
\App\Filament\Resources\PostResource::class,
]));
```
默认情况下,工具包处于只读模式。要暴露 Filament 资源的大批量操作,您可以注册具有读写模型的工具。
```php
use Kirschbaum\Loop\Loop;
use Kirschbaum\Loop\Filament\FilamentToolkit;
use Kirschbaum\Loop\Enums\Mode;
Loop::toolkit(
FilamentToolkit::make(mode: Mode::ReadWrite)
);
```
## 使用
注册工具包后,您必须将 Laravel Loop 连接到 MCP 客户端,然后工具即可使用。
## 安全
如果您发现任何与安全相关的問題,请发送电子邮件至 security@kirschbaumdevelopment.com,而不是使用问题跟踪器。
## 赞助
该软件包的开发由 Kirschbaum Development Group 赞助,这是一家专注于解决问题、团队建设和社区的开发驱动型公司。了解更多 [关于我们](https://kirschbaumdevelopment.com?utm_source=github) 或 [加入我们](https://careers.kirschbaumdevelopment.com?utm_source=github)!
## 许可证
MIT 许可证(MIT)。请参阅 [许可证文件](LICENSE) 以获取更多信息。