Laravel Forge MCP

Laravel Forge MCP服务器

](https://hub.docker.com/r/ddrcn/forge-mcp)   

用于管理Laravel Forge服务器、站点和部署的模型上下文协议（MCP）服务器。与任何MCP客户端兼容。

特性

• 179工具 -完全控制锻造API
• 9资源 -综合文件和最佳做法
• 6提示 -常见操作的指导工作流程
• Docker就绪 -优化容器，便于分发

快速开始

先决条件

• Docker已安装
• 伪造API令牌(在这里买一个)
• 任何兼容MCP的客户端

配置

将服务器添加到MCP客户端配置中：

{
    "mcpServers": {
        "forge": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e",
                "FORGE_API_TOKEN",
                "ddrcn/forge-mcp:latest"
            ],
            "env": {
                "FORGE_API_TOKEN": "your_token_here"
            }
        }
    }
}

替换 your_token_here 使用您的Forge API令牌。

本地运行（无Docker）

{
    "mcpServers": {
        "forge": {
            "command": "php",
            "args": ["/path/to/forge-mcp/artisan", "mcp:start", "forge"],
            "env": {
                "FORGE_API_TOKEN": "your_token_here"
            }
        }
    }
}

可用工具

服务器（13个工具）

网站（18个工具）

部署（11个工具）

SSL证书（7个工具）

数据库（10个工具）

复合工具（5个工具）

其他工具

总计：179个工具

可用资源

可用提示

发展

构建Docker镜像

docker build -t ddrcn/forge-mcp:latest .

本地测试

# Via Docker
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | \
  docker run --rm -i -e FORGE_API_TOKEN=your_token ddrcn/forge-mcp:latest

# Via PHP
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | \
  FORGE_API_TOKEN=your_token php artisan mcp:start forge

运行测试

php artisan test

CI/CD

本项目使用GitHub Actions进行持续集成和部署：

• 测试：推送和拉取请求时自动运行
• 码头工人：镜像被构建并在推送到master时推送到Docker Hub

必需的秘密

在GitHub存储库设置中配置这些机密：

自动发布

发布是基于常规提交自动创建的：

当您推送到master时，工作流将：

1. 分析自上次标记以来的提交
2. 确定版本差异
3. 使用changelog创建GitHub版本
4. 构建和推送Docker镜像

手动释放

要手动触发释放：

git tag v1.1.0
git push origin v1.1.0

故障排除

连接问题

1. 确保Docker正在运行
2. 验证 FORGE_API_TOKEN 设置正确
3. 配置更改后重新启动MCP客户端

API错误

# Test API directly
curl -H "Authorization: Bearer $FORGE_API_TOKEN" \
     -H "Accept: application/json" \
     https://forge.laravel.com/api/v1/servers

文档

• 锻造API文档
• MCP规范

许可证

该项目根据MIT许可证获得许可。

致谢

• Laravel Forge -服务器管理平台
• 模型上下文协议 -MCP规范
• Laravel MCP -Laravel MCP实现