MCP-сервер Material Design

Cloudflare Worker, предоставляющий сервер MCP (Model Context Protocol) для просмотра документации Material Design 3.

Возможности

• list_sections — обнаружение разделов документации верхнего уровня (Foundations, Components, Styles и т. д.)

• get_page — навигация по любой странице Material Design и получение её содержимого в виде чистого Markdown

Related MCP server: mdbook-mcp-server

Архитектура

• Среда выполнения: Cloudflare Workers (TypeScript, nodejs_compat)

• Маршрутизатор: Hono

• Автоматизация браузера: Browser Run (привязка Puppeteer)

• Преобразование в Markdown: Workers AI toMarkdown()

• Транспорт MCP: Streamable HTTP (@modelcontextprotocol/server v2)

Поскольку m3.material.io является SPA с активным использованием JavaScript, воркер использует Puppeteer для ожидания отрисовки клиентского элемента <article> перед извлечением контента.

Предварительные требования

• Node.js 18+

• pnpm

• Учетная запись Cloudflare с:

  • включенным Browser Run

  • включенным Workers AI

Настройка

# Install dependencies
pnpm install

# Generate TypeScript types from wrangler.jsonc
pnpm run gen:cf-types

Разработка

# Start local dev server (connects to remote Cloudflare services)
pnpm dev

Конечная точка MCP доступна по адресу http://localhost:8787/mcp.

Развертывание

pnpm deploy

Инструменты MCP

list_sections

Возвращает разделы документации верхнего уровня из карты сайта Material Design.

Входные данные: отсутствуют

Пример вывода:

blog
components
develop
foundations
get-started
styles

get_page

Переходит на указанную страницу Material Design, извлекает содержимое статьи и преобразует его в Markdown.

Входные данные:

• path — путь URL на m3.material.io (например, /foundations/overview)

Пример вывода:

## Accessibility & Material Design

**Accessibility by default** is a core design value for Material...

Подключение MCP-клиента

Любой MCP-клиент, поддерживающий Streamable HTTP, может подключиться к:

https://<your-worker>.<your-subdomain>.workers.dev/mcp

Например, с помощью Claude Desktop:

{
    "mcpServers": {
        "material-design": {
            "url": "https://material-mcp.your-account.workers.dev/mcp"
        }
    }
}

Лицензия

MIT