mcpField
T
tilda-mcp

tilda-mcp

本地服务
github.com/theYahia商业与营销228 周前更新

关于 tilda-mcp

tilda-mcp 通过 Tilda API 将项目和页面接入 AI Agent。它面向需要查看项目与页面信息、获取页面标记内容,或导出带本地化资源页面的用户。

主要功能

  1. 01列出项目及项目详情
  2. 02列出页面和发布日期
  3. 03获取页面完整 HTML、CSS 和 JS
  4. 04导出包含本地化资源的页面
  5. 05仅返回页面元数据而不含标记内容

适用场景

  1. 01查看项目及其页面发布日期
  2. 02检查页面的 HTML 和 CSS
  3. 03导出页面用于自托管
  4. 04获取页面内容并插入 CMS 模板

MCP 相关

将七项 Tilda API 操作作为工具提供给 MCP 客户端,涵盖项目、页面、页面内容和导出。支持通过 stdio 配置客户端,也支持无状态的可流式传输 HTTP 模式。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"theyahia-tilda": {
"command": "npx",
"args": [
"-y",
"@theyahia/tilda-mcp"
],
"env": {
"TILDA_PUBLIC_KEY": "<TILDA_PUBLIC_KEY>"
}
}
}
}
启动命令npx -y @theyahia/tilda-mcp
需要配置的环境变量
TILDA_PUBLIC_KEY密钥API key for the service

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@theyahia/tilda-mcp1.0.0

工具

3

收录的工具列表 · 更新于 2 周前

此工具无需参数。

README 原文English

来自项目 README

README 暂无中文译文,以下为英文原文;中文介绍见上方。

MCP-сервер для Tilda API — 7 инструментов для ИИ-агента: проекты, страницы, экспорт

Если вы искали, как подключить сайт на Tilda к Claude или другому ИИ-агенту, — этот сервер отдаёт агенту ваши проекты и страницы через Tilda API: список страниц с датами публикации, полный HTML и CSS любой страницы, экспорт проекта целиком. Спрашиваете «что за страницы в проекте и когда их публиковали» — агент отвечает таблицей, а не ссылкой на документацию. Нужны только публичный и секретный ключи из настроек Tilda.

npm License: MIT

Демонстрация: вопрос «что за страницы в проекте и когда их публиковали» — агент вызывает get_pages и отвечает таблицей страниц с датами

Часть серии 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_projectsgetprojectslistСписок проектов
get_project_infogetprojectinfoИнформация о проекте (домен, настройки экспорта). Опц. webconfig=htaccess|nginx → пример конфига веб-сервера
get_pagesgetpageslistСписок страниц проекта
get_pagegetpagefullПолная страница (HTML c <head>, CSS, JS; ссылки на Tilda CDN)
get_page_bodygetpageТолько тело страницы (HTML без <head>; ссылки на CDN) — для быстрого чтения/preview
get_page_exportgetpagefullexportЭкспорт полной страницы с локализованными ассетами {from,to} — для самостоятельного хостинга
get_page_export_bodygetpageexportЭкспорт тела страницы с локализованными ассетами — для вставки в свой шаблон/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


Часть WWmcp · Telegram: @vhodvai

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。