pencms MCP sunucusu
Commit 17 Eki 2026Yerel bir MCP server aracılığıyla yapay zeka ajanlarının ve insanların Markdown odaklı içerikler üzerinde iş birliği yapmasına olanak tanır.
Ayrıca bilinen adı slpstream/pencms
- Yıldızlar
- 1
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 17 Eki 2026
- Lisans
- MIT
pencms MCP nedir?
pencms bir MCP sunucusudur. Yerel bir MCP server aracılığıyla yapay zeka ajanlarının ve insanların Markdown odaklı içerikler üzerinde iş birliği yapmasına olanak tanır.
Özet, projenin README dosyasından oluşturuldu
pencms MCP sunucusu hakkında
pencms, headless mimarisi sayesinde hem yapay zeka ajanlarının hem de insanların Markdown odaklı içerikler üzerinde iş birliği yapmasını sağlar. Bu self-hosted sistem, düz dosyaları yönetmek için bir Python FastAPI backend ve bir PHP admin ön yüzü kullanır. Taslaklar için ikincil bir veritabanı yerine Markdown ve YAML'a dayandığı için, ajanlar ve insanlar her zaman aynı doğruluk kaynağı üzerinde çalışır.
Geliştiriciler bunu bir dizüstü bilgisayarda yerel olarak veya Docker Compose ve Caddy kullanarak bir VPS üzerinde dağıtabilirler. Kurulum, 8008 portunda çalışan bir Python backend ve 8009 portunda bir PHP ön yüzü gerektirir. Ajanlar, iptal edilebilir erişim anahtarları kullanarak /api/mcp adresindeki MCP endpoint'i üzerinden sistemle etkileşime girer. Bu durum, Git uzak depoları, disk depolama ve TLS ayarları üzerinde kontrolü korurken yüksek hızlı okuma ve yazma imkanı sağlar. Sistem ayrıca, sorguların daha küçük makinelerde bile yanıt verebilir kalmasını sağlamak için yerel bir SQLite indeksi içerir.
Neler yapabilirsiniz
- 1Ajan tabanlı içerik oluşturmaBir yapay zeka ajanı, yeni gönderiler yayınlamak için Markdown dosyalarınızı doğrudan okuyabilir ve yazabilir.
- 2Uzak depolarla senkronizasyonShell erişimine ihtiyaç duymadan, HTTPS REST API'lerini kullanarak içeriğinizi GitHub veya GitLab ile senkronize edebilirsiniz.
- 3Çoklu ajan iş akışlarını yönetmeTek bir operatör, ayrı erişim anahtarları atayarak birden fazla yapay zeka ajanını yönetebilir.
- 4İnsan odaklı içerik yönetimiKullanıcılar, özel bir PHP admin arayüzü aracılığıyla temaları, depolamayı ve yapıyı yönetebilirler.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Yapılandırma
PHP_CLI_SERVER_WORKERS
| Ad | Açıklama | Sunucu |
|---|---|---|
| PHP_CLI_SERVER_WORKERS | — |
Otomatik kontroller
Çalıştırıldı 15 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirslpstream/pencms is public and reachablegithub.com/slpstream/pencms ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-17github.com/slpstream/pencms ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Many 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 soruları
İnsanlar ve yapay zeka ajanları içerikle nasıl etkileşime girer?
İnsanlar PHP admin ön yüzünü kullanırken, ajanlar içeriği doğrudan okumak ve yazmak için MCP server kullanır.
İçerik nerede saklanır?
Tüm sayfalar, gönderiler ve girişler, flat-file sisteminde temiz Markdown ve YAML dosyaları olarak saklanır.
Veritabanı gerektirir mi?
Flat-file tabanlı bir doğruluk kaynağı kullanır; ancak yüksek performanslı sorgular sürdürmek için yazma işlemi sırasında yerel bir SQLite indeksi kullanır.