关于 Total CMS
Total CMS 是面向网页设计师、自由职业者和代理机构的 PHP 平面文件 CMS,以 JSON 文件存储内容,并提供管理界面、Twig 模板和 CLI。它还内置 MCP 服务,可供 AI Agent 查询站点集合与搜索。
主要功能
- 01JSON 文件存储,无需数据库
- 0233 种内置集合类型与自定义 schema
- 03Twig 模板及扩展功能
- 04管理界面与媒体管理
- 05REST API 与 tcms 命令行
- 06自动化与图像处理
适用场景
- 01在普通 PHP 主机部署内容站点
- 02通过 Twig 模板呈现结构化内容
- 03使用 REST API 构建无头站点
- 04让 AI Agent 查询集合与搜索
MCP 相关
内置 MCP 服务向 AI Agent 开放站点集合与搜索功能;该功能标注为 Pro 版提供。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://totalcms.co/mcpclaude mcp add --transport http co-totalcms-docs https://totalcms.co/mcp{"mcpServers":{"co-totalcms-docs":{"type":"http","url":"https://totalcms.co/mcp"}}}在 Cursor 中打开{"servers":{"co-totalcms-docs":{"type":"http","url":"https://totalcms.co/mcp"}}}在 VS Code 中打开{"mcpServers":{"co-totalcms-docs":{"type":"http","url":"https://totalcms.co/mcp"}}}{"mcpServers":{"co-totalcms-docs":{"serverUrl":"https://totalcms.co/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Total CMS
一款现代化的 PHP 扁平文件 CMS — 无需数据库
关于
Total CMS 是一款基于 PHP 8.2+ 和 Slim 4 构建的内容管理系统,将内容存储为扁平 JSON 文件, 而非存入数据库。无需配置 MySQL,无需运行迁移,也无需维护插件生态系统 — 内容存放在磁盘上, 因此可以像其他代码一样进行版本控制、备份和部署。
它面向网页设计师、自由职业者和代理机构,让他们能够在任何普通 PHP 主机上,为客户提供结构化内容和精致的管理界面。
- 无需数据库 — 内容以 JSON 文件形式存储在磁盘上;复制文件即可部署
- 内置 33 种集合类型 — 博客、图片、图库、文件等 — 还支持无限量自定义架构
- Twig 模板 — 在原版 Twig 3 的基础上提供 89 个自定义过滤器和 49 个函数
- 站点构建器 — 在管理界面中添加页面即可上线;无需构建或生成步骤
- REST API — 提供完整的无头模式 CRUD 操作,支持 API 密钥或 OAuth 2.1 身份验证
- 内置 MCP 服务 — 向 AI Agent 提供站点集合和搜索功能(Pro)
- 自动化 — 支持计划任务、Webhook 和事件触发处理程序,并配有作业队列
- 扩展 — 采用注册/启动生命周期,并基于能力进行权限管理
- 管理界面 — 表单构建器支持 20 多种字段类型,另有媒体管理和通行密钥登录
- 命令行工具(
tcms) — 支持集合、架构、对象、导入/导出、同步和部署 - 图像处理 — 支持按需调整大小、添加水印和 OKLCH 颜色处理
要求
- PHP 8.2+(支持 8.4)
- Composer 2.0+
- 支持 URL 重写的 Apache 或 Nginx
- PHP 扩展:GD 或 ImageMagick、JSON、Fileinfo、OpenSSL
无需数据库服务器。生产环境无需 Node.js 运行时。
安装
composer create-project totalcms/totalcms mysite
cd mysite
将 Web 服务器的文档根目录指向 public/,然后在浏览器中打开站点 — 设置向导会引导你完成管理员帐户、
数据目录和许可证的配置。
安装程序还提供子路径布局,可从 /tcms/ 提供 Total CMS,同时将 public/ 留给你自己的前端构建。
有关 Web 服务器配置,请参阅安装指南。
Twig 模板
{% for post in cms.collection.objects('blog') %}
<article>
<h2>{{ post.title }}</h2>
{{ post.content|markdown }}
</article>
{% endfor %}
完整的过滤器和函数参考,请参阅 Twig 文档。
命令行工具
vendor/bin/tcms collection:list
vendor/bin/tcms jumpstart:export backup.json
vendor/bin/tcms cache:clear
vendor/bin/tcms deploy
面向 AI Agent
Total CMS 专为编码 Agent 开发而设计:
- llms.txt 和 llms-full.txt — 一次获取完整文档
- Agent 技能 — 在运行
composer install时自动安装到.claude/skills/, 涵盖集合、架构、命令行工具和站点构建器工作流 - 内置 MCP 服务 — 让 Agent 连接到运行中的站点,直接查询其集合和架构(Pro 版)
文档
完整文档请访问 docs.totalcms.co。
支持
许可证
Total CMS 是商业软件。生产环境中使用需要许可证。条款请参阅 LICENSE.md。
可免费试用 45 天——无需信用卡。详情请访问 totalcms.co。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。