pencms MCP server
Commit 17. Okt. 2026Ermöglicht die Zusammenarbeit zwischen KI-Agenten und Menschen an Markdown-zentrierten Inhalten über ein Headless CMS mit nativem MCP server.
Auch bekannt als slpstream/pencms
- Stars
- 1
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 17. Okt. 2026
- Lizenz
- MIT
Was ist pencms MCP?
pencms ist ein MCP server. Ermöglicht die Zusammenarbeit zwischen KI-Agenten und Menschen an Markdown-zentrierten Inhalten über ein Headless CMS mit nativem MCP server.
Zusammenfassung generiert aus dem README des Projekts
Über pencms MCP server
Die Zusammenarbeit an Markdown-zentrierten Inhalten mit sowohl KI-Agenten als auch Menschen ist das, was pencms durch seine Headless-Architektur ermöglicht. Dieses selbstgehostete System nutzt ein Python FastAPI Backend und ein PHP Admin-Frontend zur Verwaltung von Flat Files. Da es auf Markdown und YAML statt auf einer sekundären Datenbank für Entwürfe setzt, arbeiten Agenten und Menschen immer an derselben Source of Truth.
Entwickler können dies lokal auf einem Laptop oder auf einem VPS mittels Docker Compose und Caddy deployen. Das Setup erfordert ein Python Backend auf Port 8008 und ein PHP Frontend auf Port 8009. Agenten interagieren mit dem System über den MCP Endpoint unter /api/mcp mittels widerruflicher Access Keys. Dies ermöglicht schnelles Lesen und Schreiben bei gleichzeitiger Kontrolle über Git Remotes, Disk-Speicher und TLS-Einstellungen. Das System enthält zudem einen lokalen SQLite-Index, um sicherzustellen, dass Abfragen auch auf kleineren Maschinen reaktionsschnell bleiben.
Was du damit machen kannst
- 1Agentic Content CreationEin KI-Agent kann direkt in deine Markdown-Dateien lesen und schreiben, um neue Posts zu veröffentlichen.
- 2Synchronisierung mit Remote-RepositoriesDu kannst deine Inhalte über HTTPS REST APIs mit GitHub oder GitLab synchronisieren, ohne Shell-Zugriff zu benötigen.
- 3Verwaltung von Multi-Agent-WorkflowsEin einzelner Operator kann mehrere KI-Agenten verwalten, indem er individuelle Access Keys vergibt.
- 4Menschliche Content-AdministrationNutzer können Themes, Speicherort und Struktur über ein dediziertes PHP Admin-Interface verwalten.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Konfiguration
PHP_CLI_SERVER_WORKERS
| Name | Beschreibung | Typ |
|---|---|---|
| PHP_CLI_SERVER_WORKERS | — |
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarslpstream/pencms is public and reachablegithub.com/slpstream/pencms ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-17github.com/slpstream/pencms ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenMany agents via keys. One operator.
PenCMS is a self-hosted, MIT-licensed Markdown and Git CMS with a Python (FastAPI) backend and a PHP admin frontend. Humans and agents edit the same flat files with no hidden state or secondary database. You control the machine — disk, Git remotes, TLS, and revocable access keys — while agents read and publish directly through MCP.
Self-Hosting PenCMS? Follow the step-by-step Quickstart Guide to get the Python Backend and PHP Frontend running on your machine in 5 minutes.
Key Principles
- Contract-First: Every backend endpoint, schema, and validation rule is defined in a hand-written OpenAPI specification (
core/openapi.yaml). - Flat-File Source of Truth: All pages, posts, and entries are stored as clean Markdown + YAML files. No second database of “AI drafts.”
- Two doors: PHP admin for humans (structure, keys, themes, storage); MCP (
/api/mcp) for agents (read/write at agent speed). - High-Performance Query Cache: Reads use a local SQLite index on write, so the CMS stays responsive on small machines.
- Shell-Free Git Syncing: Remote repos (GitHub/GitLab) via HTTPS REST APIs when a shell is restricted.
- Selfhosting: Run locally, on LAN HTTPS, or a small VPS.
PenCMS v0.2.0 explicitly bundles Traven Editor v0.3.0.
Repository Structure
pencms/
├── core/ # Contract & Specifications
│ ├── openapi.yaml # API Spec (Source of Truth)
│ ├── schemas/ # Document Schemas
│ └── docs/ # Guides (incl. quickstart.md, mcp_guide.md)
│
├── backend-python/ # FastAPI CMS + MCP + OAuth (the product brain, its backend)
│
└── frontend-php/ # Admin UI client (bundles Traven Editor v0.3.0)
Run / Deploy
| Path | Doc |
|---|---|
| Self-hosting on your own hardware (ELI5 Quickstart) | Step-by-step beginner guide — core/docs/quickstart.md |
| VPS / public HTTPS | Docker Compose + Caddy — core/docs/deploy_compose.md (deploy/) |
| LAN home server | mkcert + reverse proxy — core/docs/lan_https.md |
| An agent’s own site | core/docs/agent-owned-site.md |
| Agents / MCP / OAuth | core/docs/mcp_guide.md |
| Users + agent keys | core/docs/users-and-access.md |
2-Minute Local Quickstart (Laptop / Desktop)
PenCMS runs as two coordinated engines—the Python Backend (API & storage on :8008) and the PHP Frontend (Admin UI & Blog on :8009).
-
Start the Backend (Terminal 1):
cd backend-python python3 -m venv venv && source venv/bin/activate pip install -r requirements.txt playwright install chromium uvicorn app.main:app --reload --port 8008 -
Start the Frontend (Terminal 2):
cd frontend-php PHP_CLI_SERVER_WORKERS=8 php -c php.ini -S 127.0.0.1:8009 -t public router.php -
Initialize & Explore:
- Create your admin account: http://127.0.0.1:8009/admin/setup.php
- Admin Dashboard: http://127.0.0.1:8009/admin/
- Public Blog: http://127.0.0.1:8009/blog/
👉 For full step-by-step guidance, home server setup, and troubleshooting, read the ELI5 Quickstart Guide.
Docker Compose (VPS / Public HTTPS)
For cloud VPS deployments with automatic Let's Encrypt TLS:
cd deploy
cp .env.example .env # set PUBLIC_HOST, JWT_SECRET, JWT_ISSUER, MCP_RESOURCE_URL, CORS_ALLOW_ORIGINS
docker compose up -d --build
See core/docs/deploy_compose.md for full VPS configuration and reverse proxy details.
License
Open-source, licensed under the MIT License.
pencms MCP Fragen
Wie interagieren Menschen und KI-Agenten mit den Inhalten?
Menschen nutzen das PHP-Admin-Frontend, während Agenten den MCP server verwenden, um Inhalte direkt zu lesen und zu schreiben.
Wo werden die Inhalte gespeichert?
Alle Seiten, Posts und Einträge werden als saubere Markdown- und YAML-Dateien in einem Flat-File-System gespeichert.
Wird eine Datenbank benötigt?
Es wird eine Flat-File-Source-of-Truth genutzt, verwendet jedoch einen lokalen SQLite-Index beim Schreiben, um performante Abfragen zu gewährleisten.