MCP server pencms
Коммит 17 окт. 2026 г.Позволяет ИИ-агентам и людям совместно работать с контентом на базе Markdown через headless CMS с нативным MCP server.
Также известен как slpstream/pencms
- Звёзды
- 1
- Инструменты
- —
- Загрузки, 30 дней
- —
- Последняя версия
- —
- Последний коммит
- 17 окт. 2026 г.
- Лицензия
- MIT
Что такое pencms MCP?
pencms — это MCP server. Позволяет ИИ-агентам и людям совместно работать с контентом на базе Markdown через headless CMS с нативным MCP server.
Сводка сгенерирована из README проекта
О pencms MCP server
pencms позволяет ИИ-агентам и людям совместно работать с контентом на базе Markdown благодаря своей headless архитектуре. Эта self-hosted система использует Python FastAPI backend и PHP admin frontend для управления плоскими файлами. Поскольку для черновиков используются Markdown и YAML, а не отдельная база данных, агенты и люди всегда работают с одним и тем же источником истины.
Разработчики могут развернуть систему локально на ноутбуке или на VPS, используя Docker Compose и Caddy. Настройка требует наличия Python backend на порту 8008 и PHP frontend на порту 8009. Агенты взаимодействуют с системой через MCP endpoint по адресу /api/mcp, используя отзываемые ключи доступа. Это обеспечивает высокую скорость чтения и записи при сохранении контроля над Git remotes, дисковым хранилищем и настройками TLS. Система также включает локальный индекс SQLite, чтобы запросы оставались быстрыми даже на маломощных устройствах.
Что вы можете с ним делать
- 1Агентское создание контентаИИ-агент может напрямую читать и записывать данные в ваши Markdown файлы для публикации новых постов.
- 2Синхронизация с удаленными репозиториямиВы можете синхронизировать контент с GitHub или GitLab через HTTPS REST API, не имея доступа к shell.
- 3Управление рабочими процессами нескольких агентовОдин оператор может управлять несколькими ИИ-агентами, выдавая им индивидуальные ключи доступа.
- 4Администрирование контента человекомПользователи могут управлять темами, хранилищем и структурой через выделенный PHP admin интерфейс.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Конфигурация
PHP_CLI_SERVER_WORKERS
| Название | Описание | Тип |
|---|---|---|
| PHP_CLI_SERVER_WORKERS | — |
Автоматические проверки
Запущено 15 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийslpstream/pencms is public and reachablegithub.com/slpstream/pencms ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-17github.com/slpstream/pencms ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPНе проверялось
README
Открыть на GitHubMany 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
Как люди и ИИ-агенты взаимодействуют с контентом?
Люди используют PHP admin frontend, а агенты используют MCP server для прямого чтения и записи контента.
Где хранится контент?
Все страницы, посты и записи хранятся в виде чистых Markdown и YAML файлов в flat-file системе.
Требуется ли база данных?
Система использует flat-file в качестве основного источника данных, но при записи задействует локальный индекс SQLite для обеспечения высокой производительности запросов.