GTM-LABS-io/mcp-server

GTM Labs MCP Server

Access GTM Labs components directly from GitHub - always up-to-date!

Get instant access to GTM Labs components through AI assistants. No git clone needed - components are fetched directly from GitHub's API, so you always get the latest version.

🎯 What This Does

The GTM Labs MCP Server fetches components directly from GitHub, allowing you to:

✅ Access any component instantly via natural language
✅ Always get the latest - no git pull needed!
✅ Get full blueprints with code and dependencies
✅ Search components across all projects
✅ Extract design specs (colors, animations, etc.)
✅ No local storage - components fetched on demand

🚀 Quick Install

One-Line Install

curl -fsSL https://raw.githubusercontent.com/GTM-LABS-io/mcp-server/main/install.sh | bash

That's it! No git clone needed. Components are fetched directly from GitHub.

What Gets Installed

• MCP SDK
• requests library (for GitHub API)
• GTM Labs MCP server
• IDE configuration (Windsurf/Claude Desktop)

Optional: GitHub Token

For higher rate limits (5,000 requests/hour instead of 60):

1. Create a token at https://github.com/settings/tokens
2. No special permissions needed
3. Add to ~/.gtm-labs-mcp/config.json:

{
  "github_token": "your_token_here"
}

⚙️ IDE Configuration

Windsurf

Create .windsurf/mcp_config.json:

{
  "gtm-labs": {
    "command": "python3.11",
    "args": ["/Users/YOUR_USERNAME/.mcp-servers/gtm-labs/server.py"]
  }
}

Restart Windsurf.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "gtm-labs": {
      "command": "python3.11",
      "args": ["/Users/YOUR_USERNAME/.mcp-servers/gtm-labs/server.py"]
    }
  }
}

Restart Claude Desktop.

Other MCP-Compatible Tools

Follow your tool's MCP configuration guide using:

• Command: python3.11
• Args: ["/path/to/.mcp-servers/gtm-labs/server.py"]

🧪 Testing

Once installed, try these commands in your AI assistant:

Use GTM Labs MCP to list all components
Use GTM Labs MCP to get the how-we-help-section component
Use GTM Labs MCP to show me the design tokens
Use GTM Labs MCP to search for animation components

Expected: JSON responses with component code, specs, and metadata.

📚 Available Tools

1. list_components

List all components, optionally filtered by category.

Example:

List all section components using GTM Labs MCP

2. get_component

Get a component with full blueprint (code, dependencies, specs).

Example:

Get the hero-section component with all dependencies

3. get_component_specs

Get detailed specifications (colors, animations, borders, spacing, fonts).

Example:

Show me the color specs for hero-section

4. search_components

Search components by name, content, or properties.

Example:

Search for components with animation effects

5. get_changelog

Get version history for a component or entire project.

Example:

Show changelog for hero-section

6. create_scaffold

Create a project scaffold with selected components.

Example:

Create a Next.js scaffold with hero and navbar at ./new-project

🎨 What's Available

Components (50+)

• Sections: hero, how-we-help, how-it-works, content-library
• UI: buttons, cards, inputs, banners, tooltips
• Animations: Custom animation components
• Cosmic: Custom design system (15+ components)
• MagicUI: Magic effects library (8+ components)
• Experiments: Bento grids, experimental layouts

Configuration

• Tailwind config (270 lines, custom animations)
• Design tokens (256 lines, complete design system)
• Next.js config
• Package.json with all dependencies

Utilities

• Helper functions
• Design system tokens
• Brand constants

🔐 Security

The MCP automatically:

• Excludes: .env*, *secrets*, *private*, internal docs
• Redacts: API keys, CRM tool names, credentials
• Only exposes: Public-facing code (components, configs, utilities)

📖 Documentation

• - Browse all components
• - Complete API reference
• - Version control workflow
• - How to distribute

🛠️ Configuration

Project Path

The MCP needs to know where your GTM Labs project is located.

Config file: ~/.gtm-labs-mcp/config.json

{
  "project_root": "/Users/yourname/projects/gtm-homepage"
}

Update this path to point to your GTM Labs project directory.

💡 Use Cases

1. Quick Component Reuse

Get the how-we-help-section component with all dependencies

→ Instant access to component code, styles, and dependencies

2. Create New Project

Create a Next.js scaffold with hero, navbar, and footer at ./my-new-project

→ Full project skeleton with your components

3. Extract Specific Styles

What colors does the cosmic-card component use?

→ Exact Tailwind classes and color values

4. Version Control

Get hero-section from version v1.0.0

→ Access any historical version

🐛 Troubleshooting

MCP Not Loading

1. Check Python version: python3.11 --version (must be 3.10+)
2. Check MCP installed: pip3.11 show mcp
3. Verify config path: cat ~/.gtm-labs-mcp/config.json
4. Test server: python3.11 ~/.mcp-servers/gtm-labs/server.py (Ctrl+C to stop)
5. Restart your IDE completely

Component Not Found

• Verify project path in ~/.gtm-labs-mcp/config.json
• Check component exists: ls /path/to/project/homepage/components/ui/
• Use exact component name (kebab-case): hero-section, not HeroSection

Python Version Error

ERROR: Package 'mcp' requires a different Python: 3.9.6 not in '>=3.10'

Solution: Install Python 3.11+

brew install python@3.11  # macOS
sudo apt install python3.11  # Linux

🤝 Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

📄 License

MIT License - see file

🔗 Links

• GitHub: https://github.com/gtm-labs/mcp-server
• Documentation: https://github.com/gtm-labs/mcp-server/wiki
• Issues: https://github.com/gtm-labs/mcp-server/issues
• MCP Protocol: https://modelcontextprotocol.io

🎉 Credits

Built by GTM Labs for the MCP community.

Powered by:

• Model Context Protocol
• Next.js
• Tailwind CSS
• Framer Motion

Questions? Open an issue on GitHub or check the .