# Phlow MCP Server

Local agent execution environment that separates planning, coding, and review steps while enforcing test and linter checks before finalizing changes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed
- Author: qompassai
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qompassai/phlow
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/phlow-mcp-server

## What it does

Phlow operates as a guarded runtime where development tasks pass through planner, coder, and reviewer phases. Instead of letting an AI run unrestricted shell commands or scripts, the server restricts file operations to atomic reads and writes with relative paths. Any attempts to traverse parent folders, touch symlinks, or access `.git` directories are blocked immediately.

Code modifications require explicit proof before they count as verified. An operator-defined TOML configuration specifies which test suites and linters must succeed. If a required check fails, a modified file lacks static coverage, or the step budget runs out, the runtime rejects the result. Without the required test or lint binaries preinstalled in the target virtual environment, the verification pipeline halts.

The server needs a POSIX platform (macOS or Linux), Python 3.11+, the `uv` tool, and a running Ollama service with a tool-supporting model. By default, configuration targets `qwen2.5-coder:7b`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- run multi-step planning, coding, and review workflows locally
- restrict file modifications to relative paths inside the workspace
- gate code changes behind mandatory test and lint verifications
- connect local Ollama models through a sandboxed execution runtime

## Example prompts
- Check the project status and Phlow configuration in the current workspace
- Fix failing parser tests and run configured verification checks

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md