https://github.com/shantoislamdev/material-web-mcp

An MCP server providing programmatic access to Material Web documentation for AI agents (Claude, Cursor, Cline, Copilot, etc.).
https://github.com/shantoislamdev/material-web-mcp

material-design material-ui material-web mcp mcp-server mwc

Last synced: 5 months ago
JSON representation

An MCP server providing programmatic access to Material Web documentation for AI agents (Claude, Cursor, Cline, Copilot, etc.).

• Host: GitHub
• URL: https://github.com/shantoislamdev/material-web-mcp
• Owner: shantoislamdev
• License: other
• Created: 2025-10-31T13:24:25.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-11-15T16:38:26.000Z (7 months ago)
• Last Synced: 2025-11-15T18:24:30.798Z (7 months ago)
• Topics: material-design, material-ui, material-web, mcp, mcp-server, mwc
• Language: JavaScript
• Homepage:
• Size: 587 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Material Web MCP Server

[![npm version](https://img.shields.io/npm/v/material-web-mcp.svg)](https://www.npmjs.com/package/material-web-mcp)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[![Node.js Version](https://img.shields.io/badge/Node.js-%3E%3D18.17-brightgreen.svg)](https://nodejs.org/)

[![CI Status](https://img.shields.io/github/actions/workflow/status/shantoislamdev/material-web-mcp/ci.yml?branch=main&label=CI)](https://github.com/shantoislamdev/material-web-mcp/actions/workflows/ci.yml)

[![codecov](https://codecov.io/gh/shantoislamdev/material-web-mcp/graph/badge.svg?token=G2ZUHV6R4C)](https://codecov.io/gh/shantoislamdev/material-web-mcp)

[![GitHub issues](https://img.shields.io/github/issues/shantoislamdev/material-web-mcp)](https://github.com/shantoislamdev/material-web-mcp/issues)

An MCP server providing programmatic access to Material Web documentation for AI agents (Claude, Cursor, Cline, Copilot, etc.).

**Requirements:** Node.js >= 18.17

## Quick Start

Connect to AI agents using npx (no installation required):

```json

{

  "mcpServers": {

    "material-web": {

      "command": "npx",

      "args": ["-y", "material-web-mcp"]

    }

  }

}

```

## Tools Overview

- **list_components**: Returns JSON array of available Material Web components.

- **search_docs**: Searches documentation for keywords (input: keyword string), returns matching paths with excerpts.

- **health_check**: Verifies server uptime and documentation accessibility.

- **get_component_doc**: Fetches full documentation for a specific component (input: component name).

- **get_theming_docs**: Returns theming documentation for Material Web.

- **get_installation_docs**: Returns installation and quick-start documentation.

- **generate_template**: Generates basic HTML templates with Material Web components based on prompts (input: prompt string).

- **validate_website**: Validates HTML code for correct Material Web component usage (input: HTML string).

## Links

- [ Contributing Guide](CONTRIBUTING.md) - How to contribute

- [ Changelog](CHANGELOG.md) - Version history

## Development

### Quick Setup

```bash

git clone https://github.com/shantoislamdev/material-web-mcp.git

cd material-web-mcp

npm install

npm test

npm start

```

[MIT License](LICENSE)