关于 tilda-mcp
tilda-mcp 通过 Tilda API 将项目和页面接入 AI Agent。它面向需要查看项目与页面信息、获取页面标记内容,或导出带本地化资源页面的用户。
主要功能
- 01列出项目及项目详情
- 02列出页面和发布日期
- 03获取页面完整 HTML、CSS 和 JS
- 04导出包含本地化资源的页面
- 05仅返回页面元数据而不含标记内容
适用场景
- 01查看项目及其页面发布日期
- 02检查页面的 HTML 和 CSS
- 03导出页面用于自托管
- 04获取页面内容并插入 CMS 模板
MCP 相关
将七项 Tilda API 操作作为工具提供给 MCP 客户端,涵盖项目、页面、页面内容和导出。支持通过 stdio 配置客户端,也支持无状态的可流式传输 HTTP 模式。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
3收录的工具列表 · 更新于 2 周前
此工具无需参数。
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
MCP-сервер для Tilda API — 7 инструментов для ИИ-агента: проекты, страницы, экспорт
Если вы искали, как подключить сайт на Tilda к Claude или другому ИИ-агенту, — этот сервер отдаёт агенту ваши проекты и страницы через Tilda API: список страниц с датами публикации, полный HTML и CSS любой страницы, экспорт проекта целиком. Спрашиваете «что за страницы в проекте и когда их публиковали» — агент отвечает таблицей, а не ссылкой на документацию. Нужны только публичный и секретный ключи из настроек Tilda.
Часть серии WWmcp (46 серверов) by @theYahia.
Установка
Claude Desktop
{
"mcpServers": {
"tilda": {
"command": "npx",
"args": ["-y", "@theyahia/tilda-mcp"],
"env": { "TILDA_PUBLIC_KEY": "your-public-key", "TILDA_SECRET_KEY": "your-secret-key" }
}
}
}
Claude Code
claude mcp add tilda -e TILDA_PUBLIC_KEY=your-public-key -e TILDA_SECRET_KEY=your-secret-key -- npx -y @theyahia/tilda-mcp
VS Code / Cursor
{ "servers": { "tilda": { "command": "npx", "args": ["-y", "@theyahia/tilda-mcp"], "env": { "TILDA_PUBLIC_KEY": "your-public-key", "TILDA_SECRET_KEY": "your-secret-key" } } } }
Streamable HTTP
TILDA_PUBLIC_KEY=xxx TILDA_SECRET_KEY=yyy npx @theyahia/tilda-mcp --http --port 3001
# Endpoint: http://localhost:3001/mcp (stateless, CORS включён)
# Health: http://localhost:3001/health → {"status":"ok","tools":7}
HTTP-режим работает в stateless-режиме: на каждый POST создаётся свежий сервер+транспорт (подходит для чистой API-обёртки, поддерживает несколько клиентов без коллизий сессий). Принимает POST/OPTIONS на /mcp; прочие методы → 405.
Smithery
npx @smithery/cli install @theyahia/tilda-mcp
Требуется
TILDA_PUBLIC_KEYиTILDA_SECRET_KEY. Получите в настройках аккаунта Tilda.
Инструменты (7)
Полное покрытие всех 7 методов Tilda API.
| Инструмент | Метод API | Описание |
|---|---|---|
get_projects | getprojectslist | Список проектов |
get_project_info | getprojectinfo | Информация о проекте (домен, настройки экспорта). Опц. webconfig=htaccess|nginx → пример конфига веб-сервера |
get_pages | getpageslist | Список страниц проекта |
get_page | getpagefull | Полная страница (HTML c <head>, CSS, JS; ссылки на Tilda CDN) |
get_page_body | getpage | Только тело страницы (HTML без <head>; ссылки на CDN) — для быстрого чтения/preview |
get_page_export | getpagefullexport | Экспорт полной страницы с локализованными ассетами {from,to} — для самостоятельного хостинга |
get_page_export_body | getpageexport | Экспорт тела страницы с локализованными ассетами — для вставки в свой шаблон/CMS |
Экономия контекста: инструменты страниц (get_page*) принимают опц. metadata_only: true — вернуть только метаданные без html/css/js (полезно для больших страниц).
Экспорт всего проекта: отдельного метода нет — получите get_pages, затем по каждому id вызовите get_page_export (или get_page_export_body).
Лимит Tilda API: 150 запросов в час. Клиент делает ретраи с экспоненциальной задержкой и учитывает заголовок
Retry-After.
Безопасность: Tilda API принимает ключи только как query-параметры (
publickey/secretkey) — это особенность самого API. Сервер не логирует URL с ключами; держите ключи в env, не передавайте их в незашифрованные логи/прокси.
Скиллы
| Скилл | Триггер |
|---|---|
/skill-get-pages | Покажи все страницы сайта |
/skill-export-page | Экспортируй страницу |
Примеры
Покажи мои проекты в Tilda
Информация о проекте 12345 с конфигом nginx
Список страниц проекта 12345
Покажи содержимое страницы 67890
Покажи только метаданные страницы 67890
Экспортируй страницу 67890 для своего хостинга
Экспортируй тело страницы 67890 для вставки в шаблон
Лицензия
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。