buefy-mcp

A lightweight, token-efficient local MCP server that exposes the full Buefy 3 component documentation to any MCP-compatible client (Claude Code, Claude Desktop, Cursor, Cline, Windsurf, etc.).

Tools

| Tool | Description | | ------------------------ | -------------------------------------------------------- | | buefy_list_components | List all 42 components with one-line descriptions | | buefy_get_component | Full docs for a component: props, events, slots, methods | | buefy_search | Search across all component docs by keyword | | buefy_get_installation | Installation and setup instructions |

Setup

npm install

Usage

node index.js

Updating the bundled docs

Re-downloads data/mcp.txt from the Buefy dev branch:

npm run update-data

Configuration

Claude Code (project)

Add to .claude/settings.json:

{
  "mcpServers": {
    "buefy": {
      "command": "node",
      "args": ["/absolute/path/to/buefy-mcp/index.js"],
      "type": "stdio"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

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

After publishing to npm

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

Testing

# List tools
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node index.js

# Get BButton docs
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"buefy_get_component","argumentnpm {"component_name":"BButton"}}}' | node index.js

# Interactive inspector
npx @modelcontextprotocol/inspector node index.js