Provides access to complete Modus Web Components documentation, design system guidelines, and project setup guides for Trimble's component library
MCP Modus
AI assistant for Modus Web Components - Get instant help with component documentation, design rules, and setup guides directly in your IDE.
What This Does
This MCP server gives AI assistants (like Cursor, Claude, VS Code) access to complete Modus Web Components documentation. Ask questions like:
"How do I use a Modus button with primary color?"
"What are the Modus color guidelines?"
"Show me how to set up a React project with Modus components"
"Which components have a disabled attribute?"
Setup
Choose one of the two options below:
Option 1: NPX (Recommended - No Installation)
For any IDE with MCP support:
Benefits: No installation required, always uses latest version, no permission issues.
Option 2: Global Install
Install globally:
npm install -g @julianoczkowski/mcp-modusNote: On some systems, you may need
sudo npm install -g @julianoczkowski/mcp-modus
Use this config:
{ "mcpServers": { "modus-docs": { "command": "mcp-modus" } } }
Benefits: Faster startup, works offline after installation.
IDE-Specific Instructions
For Cursor IDE
Go to
Settings → Features → MCP
Click "Add New MCP Server"
Use one of the JSON configs above
For VS Code (with Continue)
Add to ~/.continue/config.json
using one of the JSON configs above.
For Claude Desktop
Add to your config file using one of the JSON configs above:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%/Claude/claude_desktop_config.json
What You Get
📚 Component Documentation (43+ components)
Complete API documentation for all Modus Web Components
Usage examples and best practices
Attribute and event references
🎨 Design System Guidelines
Color palettes and usage rules
Icon guidelines and available icons
Spacing, typography, and layout systems
Border radius and stroke guidelines
⚙️ Project Setup Guides
HTML project setup instructions
React project integration guide
Theme implementation and customization
Testing guidelines and best practices
Example Usage
Once configured, ask your AI assistant:
The AI will use the MCP server to fetch the latest documentation and provide accurate, up-to-date answers.
Troubleshooting
Server Not Connecting
Ensure Node.js 18+ is installed:
node --version
For global install: verify with
mcp-modus --help
Check IDE logs for error messages
Removing Downloaded Documentation
If you used the NPX option (Option 1), the documentation is temporarily cached by NPX. To clear this cache:
If you used the Global Install option (Option 2), uninstall with:
Need Help?
Built for developers using Modus Web Components | MIT License | Made by Julian Oczkowski
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
Provides AI assistants with access to complete Modus Web Components documentation, enabling instant help with component usage, design system guidelines, and project setup directly in your IDE.