MCP Server ​

Use the BootstrapVueNext MCP server for AI-assisted migration and docs access.

Edit this page on GitHub

The @bootstrap-vue-next/mcp package is a Model Context Protocol (MCP) server that gives AI assistants direct access to the BootstrapVueNext documentation and migration knowledge base. Connect it to your AI editor or coding assistant to get accurate, up-to-date migration guidance without leaving your workflow.

Installation ​

The easiest way to use the MCP server is via npx — no local installation required:

bash
npx @bootstrap-vue-next/mcp

AI editor configuration ​

Most AI editors and assistants (Cursor, VS Code with GitHub Copilot, Claude Desktop, etc.) support MCP servers through a JSON configuration file. Add the following entry to your MCP configuration:

json
{
  "mcpServers": {
    "bootstrap-vue-next": {
      "command": "npx",
      "args": ["@bootstrap-vue-next/mcp"]
    }
  }
}

Global install ​

If you prefer to install the server globally:

bash
pnpm add -g @bootstrap-vue-next/mcp
bash
npm install -g @bootstrap-vue-next/mcp

Then reference the installed binary in your MCP config:

json
{
  "mcpServers": {
    "bootstrap-vue-next": {
      "command": "bootstrap-vue-next-mcp"
    }
  }
}

Configuration ​

Docs base URL ​

By default the server reads LLM markdown docs from the published documentation site:

https://bootstrap-vue-next.github.io/bootstrap-vue-next/

Override this with the BOOTSTRAP_VUE_NEXT_MCP_DOCS_URL environment variable to target a staging build, a pull-request preview, or a locally running docs server:

json
{
  "mcpServers": {
    "bootstrap-vue-next": {
      "command": "npx",
      "args": ["@bootstrap-vue-next/mcp"],
      "env": {
        "BOOTSTRAP_VUE_NEXT_MCP_DOCS_URL": "http://localhost:8000/bootstrap-vue-next/"
      }
    }
  }
}

Resources ​

The server exposes the following resources that AI clients can read directly:

Resource URIDescription
bootstrap-vue-next://docs/llms.txtLLM site index generated from the docs build
bootstrap-vue-next://docs/llms-full.txtFull LLM markdown corpus generated from the docs build
bootstrap-vue-next://migration/overviewTop-level migration knowledge-base overview page
bootstrap-vue-next://migration/entry/{id}Individual migration entry by its id (e.g. bmodal, v-b-tooltip)

Tools ​

The server provides the following tools for AI assistants:

ToolDescriptionArguments
fetch_migration_overviewFetches the migration knowledge-base overview and the primary cross-cutting migration entry—
fetch_migration_entryFetches a migration entry by id or aliasid (required)
search_migration_entriesSearches migration entries by component, directive, prop, or keywordquery (required); category, limit (optional)
expand_related_migration_entriesExpands the related migration entries for a given entryid (required)
identify_migration_entriesIdentifies likely migration entries from a list of termsterms[] (required); includeRelated (optional)
generate_upgrade_checklistGenerates a checklist split into likely safe rewrites and items requiring manual reviewterms[] (required); includeRelated (optional)

search_migration_entries category filter ​

The optional category argument narrows results to a specific type of migration entry:

ValueDescription
componentsComponent-level migrations (e.g. BModal, BDropdown)
directivesDirective-level migrations (e.g. v-b-tooltip, v-b-toggle)
propsProp-level changes within components
patternsCross-cutting patterns and conventions

Use Cases ​

Find migration guidance for a specific component ​

Ask your AI assistant to fetch migration details for a component or directive you are updating:

"Fetch the migration entry for BModal" "What changed for v-b-tooltip when migrating from BootstrapVue?"

The assistant will use fetch_migration_entry or search_migration_entries to retrieve the relevant guidance directly from the knowledge base.

Generate an upgrade checklist ​

When starting a migration, provide the list of BootstrapVue components and directives your project uses and ask the assistant to generate a checklist:

"Generate an upgrade checklist for BModal, BTable, BFormInput, and v-b-tooltip"

The assistant will use generate_upgrade_checklist to split the work into items that are likely safe to rewrite automatically and items that require manual review.

Search for prop-level changes ​

Ask the assistant to search for specific prop or API changes:

"Search for migration entries related to the 'size' prop" "Are there any breaking changes for the 'variant' prop?"

The assistant will use search_migration_entries with category: "props" to surface the relevant entries.