alpine-mcp

alpine-mcp

An MCP (Model Context Protocol) server that provides the complete Alpine.js documentation as resources. Gives AI assistants accurate, up-to-date reference when building with Alpine.js.

Resources

| URI | Contents | |-----|----------| | alpine://directives | All directives — x-data, x-show, x-bind, x-on, x-model, x-for, x-transition, x-effect, x-ref, x-cloak, x-teleport, x-id, and more | | alpine://magics | All magic properties — $el, $refs, $store, $watch, $dispatch, $nextTick, $root, $data, $id | | alpine://globals | Global API — Alpine.data(), Alpine.store(), Alpine.bind() | | alpine://plugins | Official plugins — Mask, Intersect, Persist, Focus, Collapse, Anchor, Morph, Sort |

Installation

Claude Desktop

Add to your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop.

Claude Code

Run in your terminal:

claude mcp add alpine -- npx -y alpine-mcp

Or add it to a project by creating/editing .claude/settings.json:

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

Cursor

Add to your global MCP config at ~/.cursor/mcp.json, or create .cursor/mcp.json in your project root:

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

Restart Cursor.

VS Code

Add to your user settings.json (open with Preferences: Open User Settings (JSON)):

{
  "mcp": {
    "servers": {
      "alpine": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "alpine-mcp"]
      }
    }
  }
}

Or scope it to a workspace by adding the same block to .vscode/settings.json.

Any MCP client

Any client that supports the Model Context Protocol stdio transport can run it directly:

npx alpine-mcp

Or install globally:

npm install -g alpine-mcp
alpine-mcp

Usage

Once registered, ask your AI assistant about Alpine.js and it will automatically reference the accurate documentation. For example:

• "How do I use x-transition with custom CSS classes?"
• "What modifiers does x-on support?"
• "How do I persist state across page loads with Alpine?"
• "Show me how to use the Focus plugin for a modal."

Development

git clone https://github.com/BillyNoyes/alpine-mcp.git
cd alpine-mcp
npm install
npm run build

Local config

{
  "mcpServers": {
    "alpine": {
      "command": "node",
      "args": ["/path/to/alpine-mcp/build/index.js"]
    }
  }
}

Content

Documentation content is sourced directly from the official Alpine.js repository and covers Alpine.js v3.

License

MIT