MCP 服务器

lenis-mcp-server

MCP server providing embedded Lenis smooth scroll expertise to AI assistants, enabling setup generation, API reference, debugging, scroll patterns, and performance optimization without network requests.

README

🎯 Lenis MCP Server

MCP server that provides Lenis smooth scroll expertise to AI assistants. Knowledge-based — no external API calls, all documentation is embedded.

📋 About

The Lenis MCP Server is a Model Context Protocol server that gives AI coding assistants deep knowledge about Lenis — the lightweight, performant smooth scroll library by darkroom.engineering.

All documentation (settings, methods, events, patterns, troubleshooting) is embedded directly in the server. When an AI assistant calls a tool, it receives structured, accurate information — no network requests, no API keys, zero latency.

🛠️ Tools

Tool	Description
🔧 `lenis_generate_setup`	Generate setup code for vanilla JS, React, Vue, Next.js (+ GSAP, snap)
📖 `lenis_get_api_reference`	Query settings, methods, events, properties with search
🐛 `lenis_debug_scroll_issue`	Diagnose scroll issues against known limitations
🎨 `lenis_create_scroll_pattern`	Production-ready patterns: parallax, snap, horizontal, WebGL sync
⚡ `lenis_optimize_performance`	Performance recommendations for your setup

🏗️ How It Works

graph LR
    A[🤖 AI Assistant] -->|Calls MCP tool| B[🎯 Lenis MCP Server]
    B -->|Queries| C[📚 Embedded Knowledge Base]
    C -->|Returns| B
    B -->|Structured response| A
    A -->|Generates code| D[💻 Your Project]

    style A fill:#6366f1,stroke:#4f46e5,color:#fff
    style B fill:#14b8a6,stroke:#0d9488,color:#fff
    style C fill:#f59e0b,stroke:#d97706,color:#fff
    style D fill:#10b981,stroke:#059669,color:#fff

📦 Installation

Via npx (recommended)

Add to your MCP config (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "lenis-mcp": {
      "command": "npx",
      "args": ["-y", "lenis-mcp-server"]
    }
  }
}

From source

git clone https://github.com/devAndreotti/lenis-mcp-server.git
cd lenis-mcp-server
npm install
npm run build

Then add to your MCP config:

{
  "mcpServers": {
    "lenis-mcp": {
      "command": "node",
      "args": ["path/to/lenis-mcp-server/dist/index.js"]
    }
  }
}

🌟 Features

Feature	Description
🚀 Zero Latency	All docs embedded — no network requests needed
🎯 Framework-Aware	Supports vanilla JS, React, Vue, and Next.js
🔗 GSAP Integration	Deep knowledge of ScrollTrigger integration
🐛 Smart Debugging	Matches symptoms against known limitations
📱 Mobile-Ready	Performance tips for touch & mobile optimization
🎨 Pattern Library	Parallax, snap, horizontal, WebGL sync, and more

💬 Example Prompts

"Set up Lenis with GSAP ScrollTrigger in my React app"
"What are all the Lenis settings and their defaults?"
"My scroll is janky on Safari, help me fix it"
"Create a parallax effect with Lenis and GSAP"
"Optimize my Lenis setup for mobile devices"
"How do I handle nested scroll containers?"

📂 Project Structure

lenis-mcp-server/
│
├── src/
│   ├── index.ts              # MCP server with 5 tools
│   └── knowledge/
│       └── lenis-docs.ts     # Complete Lenis knowledge base
│
├── package.json
├── tsconfig.json
├── LICENSE
└── README.md

🐛 Troubleshooting

Problem	Solution
Server won't start	Ensure Node.js ≥ 18 and run `npm run build` first
Tools not appearing	Check MCP config path is correct and restart your IDE
Outdated information	Open an issue or PR to update the knowledge base