1. Conduid
  2. RAG
  3. Flock
MCP server · RAG

Flock

Free, open-source local development environment for PHP and Laravel on macOS, Windows and Linux. Native processes, no Docker.

81Strong

Scored 11 hours ago · breakdown

About Flock

Flock is an MCP server published by flock-php in the RAG category: free, open-source local development environment for PHP and Laravel on macOS, Windows and Linux. Native processes, no Docker.

The repository has 563 stars and 59 forks, with the last commit 13 hours ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/flock-php/flock

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (25)

create_databaseCreate a database in Flock's PostgreSQL, MySQL or MariaDB (user postgres or root, no password).

Parameters not published.

create_worktreeCreate a git worktree of a site on a branch (a new branch from `from`, the current commit by default;

Parameters not published.

get_dumpsOutput of dump() and dd() captured by Flock (newest first), with the file and line and the request or

Parameters not published.

get_errorsRecent entries of a site's Laravel log (storage/logs, newest first) and PHP errors from Flock's PHP log.

Parameters not published.

get_eventsWhat the apps did, captured by Flock's agent while capture is on: database queries (SQL, bindings,

Parameters not published.

install_versionInstall a PHP version (e.g. 8.4: its newest release) or a Node.js version (a major, e.g. 22).

Parameters not published.

link_siteServe a project folder as a Flock site at https://<name>.test (by default the project Flock was started in, named after its folder).

Parameters not published.

list_mailMail the apps sent, caught by Flock instead of being delivered (newest first).

Parameters not published.

list_node_versionsNode.js versions: which are installed, the default, and the release lines that can be installed.

Parameters not published.

list_php_versionsPHP versions: which are installed, the default, the newest releases, and installs in progress.

Parameters not published.

Show all 25 tools
list_servicesFlock's services (MySQL, MariaDB, PostgreSQL, Redis/Valkey, Meilisearch, Typesense, MongoDB, RustFS, mail, dumps):

Parameters not published.

list_sitesEvery site Flock serves, with its URL, folder and PHP version, and the proxies (names served by a server of their own).

Parameters not published.

list_worktreesList the git worktrees Flock serves, each at <branch>.<site>.test: their branch, URL, folder,

Parameters not published.

php_extensionsThe PHP extensions a site requires (ext-* in composer.json and its locked packages), the ones its

Parameters not published.

postgres_extensionList or install the PostgreSQL extensions Flock offers (PostGIS, pgRouting, pgvector, TimescaleDB),

Parameters not published.

proxy_serverStart or stop the server of a proxy that has a command (see proxy_site); its output is the service log the proxy's command names.

Parameters not published.

proxy_siteServe a server of its own, e.g. a dashboard, an object store, a Docker container or a Go or Python app, at

Parameters not published.

read_mailOne caught mail: headers, text, the links in it (e.g. to verify a sign-up or reset a password)

Parameters not published.

serviceStart, stop or install a service (see list_services for the ids). Installs download (or build) and start it;

Parameters not published.

service_logsThe last lines of one of Flock's logs: a service (mysql, postgres, redis, ...), the web server (web),

Parameters not published.

set_debuggingTurn Xdebug or dump capture on or off. With xdebug on, requests that ask for it (the XDEBUG_SESSION

Parameters not published.

setup_worktreeSet a worktree up, or wait for the setup Flock runs (Flock sets up worktrees made with git by itself).

Parameters not published.

site_infoA site's URL(s), folder, HTTPS, the PHP and Node.js versions it uses and where they come from

Parameters not published.

statusWhether Flock runs, its default PHP and Node.js versions, ports, whether dump capture and Xdebug are on, and any problems.

Parameters not published.

update_siteChange a site:\n

Parameters not published.

Ask AI

✦

Ask AI about Flock

Powered by Claude

Ask about Flock — answers draw on its README.

Security checks

Static checks derived from the repository 12 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.

1 check has not been run yet.

Releases

v1.0.0v1.0.0 · 2 Nov 20261.0.0 (2026-11-02) Features apps: ask about opening Flock at login in the setup, not the Windows installer (4938b34) apps: show the first run's PHP and Node.js installs, and handle install links for them (daa50bf) capture: capture queries,…

README

Flock is a free, open-source local development environment for PHP and Laravel on macOS, Windows and Linux. It runs PHP, Node.js, your databases and the web server as native processes, so there's no Docker and no virtual machine. You drive it from a menu bar app on macOS, a tray app on Windows, a window with a top bar icon on Linux, or the flock command line. There's no paid tier and no account.

https://github.com/user-attachments/assets/ac36d8eb-2522-4ad7-851b-052e74e759e7

Features

  • .test domains with real HTTPS. Park a folder, or link one project, and every app gets its own .test domain, subdomains included. HTTPS works without browser warnings. See Domains and HTTPS.
  • A PHP version per project. PHP 8.1 to 8.5 run side by side, and each project picks its own. Node.js too, from .nvmrc. See PHP and Node.js.
  • Databases in one click. PostgreSQL, MySQL, MariaDB, MongoDB, Valkey, Meilisearch and RustFS (plus Typesense on macOS and Linux, and Redis on macOS) run as native processes that start with your computer. See Services.
  • Every email, caught. Mail your apps send lands in a local inbox, one per app, and never reaches real people. See Mail.
  • dump() without the mess. dump() and dd() output, queries, logs and views show up in a timeline grouped by request, with links to your editor. No code changes needed. See Dumps.
  • Step debugging, only when you need it. Xdebug slows every request, so it stays off until you turn it on. See Xdebug.
  • Git worktrees, served on their own. Each worktree gets its own domain and is set up automatically, database included. See Worktrees.
  • Share a site in one command. Send a public link to a local site through a Cloudflare tunnel. See Sharing.
  • Made for AI agents. A built-in MCP server lets coding agents like Claude Code and Cursor read your sites, mail, dumps and errors. See AI.

Flock works with any PHP project, not only Laravel.

Showcase

Installation

Download the installer for your system from flockphp.com/download or the releases, open Flock and click Set up Flock.

macOS Windows Linux
System macOS 15 Sequoia or newer, Apple silicon Windows 10 (2004) or 11, x64 Ubuntu 24.04 or newer or current Fedora, x64 or arm64; Arch Linux, x64
Installer Flock-<version>-macOS.dmg Flock-Setup-<version>-x64.exe .deb or .rpm package, or flockphp-bin from the AUR
App Menu bar Notification area (tray) Window and top bar icon

On Linux, Flock needs systemd-resolved as the system's DNS resolver (the default on Ubuntu and Fedora). The package names the command flk, because /usr/bin/flock is the system's file-locking tool; after setup, flock works too.

Flock needs ports 80 and 443. If you use another local environment, stop it first. See Installation for what setup changes on your system.

Quick start

cd ~/Code
composer create-project laravel/laravel acme
flock park                  # every folder in ~/Code is served at http://<folder>.test
flock secure acme           # HTTPS for acme.test

cd acme
flock pin php 8.5           # this project's PHP version, saved in .flockrc
flock services install postgres
flock services create-db postgres acme

Then open https://acme.test. The Quick start goes through it step by step, including the .env settings for the database and mail. Every command is listed in the CLI reference.

How Flock compares

Flock covers the same ground as Laravel Herd, Laragon and XAMPP, but it's free on every system, runs natively on macOS, Windows and Linux, and includes mail, dumps and Xdebug without a paid tier. The comparison pages go through it feature by feature:

FAQ

Is Flock free? Yes. Flock is free and open source under the AGPL-3.0. There's no paid tier and no account.

Does Flock use Docker? No. PHP, Node.js, the databases and the web server run as native processes on your machine, with no containers and no virtual machine.

Does Flock only work with Laravel? No. It's built with Laravel in mind, but any PHP project works: WordPress, Symfony, Statamic or plain PHP.

Can I switch from Herd, Valet or Laragon? Yes. Stop the other environment so ports 80 and 443 are free, then install Flock and park your projects folder. See Installation.

Building from source

Flock is a Go daemon and CLI (cmd/flock) with a native app on each system: SwiftUI on macOS (macos/), WinUI 3 on Windows (windows/) and GTK 4 with libadwaita, in Rust, on Linux (linux/).

make build      # the CLI, into bin/flock
make test       # Go tests
make lint
make app        # the macOS app, into build/macos/Flock.app

The Windows app is described in windows/README.md. On Linux, linux/build-packages.sh builds the CLI and the app into .deb and .rpm packages (it needs Rust and the GTK 4, libadwaita and WebKitGTK 6 development packages).

Contributing

Bug reports and ideas are welcome in Issues. For questions or a chat, join us on Discord or use Discussions. Pull requests start with an approved issue and go to the main branch; see CONTRIBUTING.md for how it works.

Support Flock

Flock is free and open source, forever. If it saves you time, sponsoring Flock helps keep it maintained, and a ⭐ on GitHub helps others find it.

Developed by Guava

Flock is built and maintained by Guava, a small software studio from the Czech Republic. We build custom web and mobile apps, information systems and AI tools for our clients, mostly with Laravel, Livewire and Filament.

We also maintain open-source packages for the Laravel and Filament community, such as Calendar, Knowledge Base and Icon Picker. See them all on GitHub.

Need something built? Get in touch.

Credits

License

Flock is free software, licensed under the GNU Affero General Public License v3.0 (AGPL-3.0-only). Copyright © 2026 Guava s.r.o. See NOTICE for the additional permission for the Windows App SDK.

Flock is not affiliated with or endorsed by Laravel.

README fetched from the repository 12 hours ago. The original is authoritative.

Questions

About Flock

How do I install Flock?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Flock safe to use with an AI agent?

Its trust score is 81 out of 100 (strong). It passes 4 of the 5 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Flock still maintained?

Yes — the latest release is v1.0.0 (2 Nov 2026), and the last commit was 13 hours ago. The repository has 563 stars and 49 open issues.