Laravilt

Name: Laravilt
Author: laravilt

远程服务

laravilt.com开发工具02 周前更新

代码仓库访问官网

关于 Laravilt

Laravilt 是面向使用 Laravilt 的 AI 助手的只读 MCP 服务，提供最新的软件包文档、版本信息，以及插件和安装指南。

主要功能

01浏览 Laravilt 软件包和版本
02搜索并阅读文档
03获取更新日志和依赖要求
04查看插件与安装指南
05访问同步的 MCP 资源和提示词

适用场景

01安装前检查软件包依赖要求
02查找 Laravilt 插件开发指南
03查看软件包近期变更
04查询 Vue 或 React 前端文档

MCP 相关

通过流式 HTTP 向 MCP 客户端提供软件包和文档工具、资源及 `build-resource` 提示词。公共端点无需身份验证，但按 IP 限流。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.laravilt.com/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http laravilt-laravilt https://mcp.laravilt.com/mcp

Cursor.cursor/mcp.json{"mcpServers":{"laravilt-laravilt":{"type":"http","url":"https://mcp.laravilt.com/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"laravilt-laravilt":{"type":"http","url":"https://mcp.laravilt.com/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"laravilt-laravilt":{"type":"http","url":"https://mcp.laravilt.com/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"laravilt-laravilt":{"serverUrl":"https://mcp.laravilt.com/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

此工具无需参数。

详细介绍

Laravilt

Laravilt MCP

一个公开、只读的 Model Context Protocol 服务，可为 AI 助手提供每个 laravilt/* 软件包的最新 Laravilt 文档、README、变更日志和已发布版本，包括插件系统以及 Vue/React 前端。

端点：https://mcp.laravilt.com/mcp（可流式传输的 HTTP，无需身份验证，按 IP 限流）。

连接

Claude Code

claude mcp add --transport http laravilt https://mcp.laravilt.com/mcp

Cursor / VS Code（.cursor/mcp.json 或 .vscode/mcp.json）

{
    "mcpServers": {
        "laravilt": { "type": "http", "url": "https://mcp.laravilt.com/mcp" }
    }
}

Claude Desktop（通过 mcp-remote）

{
    "mcpServers": {
        "laravilt": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.laravilt.com/mcp"] }
    }
}

其他客户端：使用可流式传输的 HTTP URL https://mcp.laravilt.com/mcp。

工具

工具	返回内容
`list-packages`	所有 Laravilt 软件包，包含描述、最新版本、发布日期、安装命令和代码库
`get-package`	单个软件包：README 摘要、最新版本、要求、前端说明（Vue 和 React）、文档索引、近期变更日志
`search-docs`	排序后的文档片段，包含路径和 GitHub 链接（可选限定软件包范围）
`read-doc`	完整文档，长页面会分页
`list-docs`	单个或所有软件包的文档树
`get-latest-versions`	`package => version` 映射和可直接粘贴的 `composer require` 命令
`get-changelog`	软件包的近期变更日志条目
`plugin-development-guide`	如何构建 Laravilt 插件，内容汇编自 `laravilt/plugins` 文档
`installation-guide`	在 Laravel 13 上安装 Laravilt，使用 `php artisan laravilt:install --stack=vue\|react`

资源： laravilt://packages 和 laravilt://docs/{package}/{path}，用于访问每份已同步的文档。提示词： build-resource。

内容如何保持最新

php artisan laravilt:sync 会扫描 laravilt GitHub 组织，以 tarball 形式下载每个软件包的默认分支，为 README.md、CHANGELOG.md、composer.json 和 docs/ 下的所有 Markdown 文件建立索引，并记录 Packagist 上发布的版本。未变更的提交会跳过。计划任务每 30 分钟运行一次；GitHub webhook（POST /webhooks/github，使用 GITHUB_WEBHOOK_SECRET 签名）会将已推送代码库的同步任务立即加入队列。

本地开发

composer install
cp .env.example .env && php artisan key:generate
touch database/database.sqlite
php artisan migrate
php artisan laravilt:sync
php artisan serve

然后打开 http://127.0.0.1:8000 查看首页，或将 MCP 客户端指向 http://127.0.0.1:8000/mcp。

php artisan test
vendor/bin/pint

配置

变量	默认值	用途
`APP_URL`		公共 URL，例如 `https://mcp.laravilt.com`
`LARAVILT_GITHUB_ORG`	`laravilt`	扫描软件包的组织
`LARAVILT_EXCLUDED_REPOS`	`mcp,laravilt.com,laravilt-dev,.github`	不属于软件包的代码库
`GITHUB_TOKEN`		可选；提高 GitHub API 速率限制
`GITHUB_WEBHOOK_SECRET`		接收 push webhook 所必需
`LARAVILT_SYNC_INTERVAL`	`30`	计划同步的间隔分钟数
`LARAVILT_SEARCH_DRIVER`	`auto`	`auto`、`fts`（SQLite FTS5）或 `like`
`LARAVILT_DOC_PAGE_SIZE`	`16000`	每个 `read-doc` 页面包含的字符数
`LARAVILT_RATE_LIMIT`	`120`	每个 IP 每分钟的 MCP 请求数
`LARAVILT_MCP_PATH`	`mcp`	MCP 端点的路径
`TRUSTED_PROXIES`		代理 IP/CIDR（位于反向代理之后时设置）

部署

执行 composer install --no-dev --optimize-autoloader，根据 .env.example 创建 .env，运行 php artisan key:generate 和 php artisan migrate --force。
运行一次 php artisan laravilt:sync。
每分钟运行一次计划任务（php artisan schedule:run），并启动一个处理 webhook 触发同步任务的队列工作进程（php artisan queue:work，或设置 QUEUE_CONNECTION=sync）。
使用 PHP-FPM 在 Web 服务器或反向代理后提供 public/，并设置 TRUSTED_PROXIES。
在每个 Laravilt 代码库（或组织）中添加 webhook，监听 push 事件，指向 https://mcp.laravilt.com/webhooks/github，并使用相同的密钥。