@primevue/mcp 4.5.5 → 5.0.0-rc.2

package/LICENSE.md

@@ -1,21 +1,45 @@
-The MIT License (MIT)
-
-Copyright (c) 2018-2025 PrimeTek
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+# PrimeUI License
+
+This package is part of **PrimeUI**, a family of commercial UI libraries by PrimeTek Informatics.
+
+## How PrimeUI May Be Used
+
+PrimeUI may be used under one of two licenses. You choose the one that applies to you based on eligibility.
+
+### Community License (Free)
+
+Free for organizations that meet all of the following criteria:
+
+- Less than $1,000,000 USD in annual gross revenue
+- Fewer than 5 developers
+- Fewer than 10 employees
+- Less than $3,000,000 USD in venture capital or outside funding
+
+Individuals, students, non-profits, and non-commercial open source projects also qualify.
+
+The Community License provides full access to the core libraries and supports up to 4 developers. It requires annual renewal by confirming continued eligibility.
+
+### Commercial License (Paid)
+
+For organizations that do not qualify for the Community License.
+
+Licensed per developer, perpetual, with one year of updates included. Renewal is optional and extends access to new versions. The Commercial Suite also includes PrimeBlocks, Theme Designer, all PrimeUI Pro components, and Premium Support.
+
+## License Key
+
+A valid license key is required to use this software. License verification is performed offline, with no telemetry and no remote connection. A missing, invalid, or expired key may cause the software to display a license notice.
+
+## Full Terms
+
+The complete license terms, eligibility details, and renewal information are available at:
+
+- Community License: https://primeui.dev/licenses/community
+- Commercial License: https://primeui.dev/licenses/commercial
+
+## Restrictions
+
+This software is distributed as a compiled package. You may not reverse-engineer, decompile, or extract its source code, redistribute it as a component library or development tool, or remove its license mechanisms. Redistributing the software so that third parties can develop with it requires a separate OEM License. See the full terms for details.
+
+---
+
+© 2026 PrimeTek Informatics. All rights reserved.

package/README.md

@@ -1,92 +1,49 @@
 # @primevue/mcp
 
-Model Context Protocol (MCP) server for PrimeVue component library. Provides AI assistants with comprehensive access to PrimeVue component documentation, props, events, slots, theming, and code examples.
+Model Context Protocol (MCP) server for PrimeVue. The package is a thin public wrapper over the shared `@primeuix/mcp` v2 core and the generated PrimeVue docs artifacts in `packages/mcp/data/mcp-data.json` and `packages/mcp/data/manifest.json`.
 
-## What is MCP?
-
-[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard that enables AI models to connect with external tools and data sources. By installing this MCP server, your AI assistant gains deep knowledge of PrimeVue components and can provide accurate, up-to-date information while helping you build Vue.js applications.
-
-## Installation
-
-### Claude Code
-
-Add the PrimeVue MCP server using the CLI:
+## Run
 
 ```bash
-# Add to your user config (available in all projects)
-claude mcp add primevue -s user -- npx -y @primevue/mcp
-
-# Or add to current project only
-claude mcp add primevue -- npx -y @primevue/mcp
+npx -y @primevue/mcp@alpha
 ```
 
-Alternatively, use the JSON format for more control:
+The public bin command is also available as:
 
 ```bash
-claude mcp add-json primevue '{"command":"npx","args":["-y","@primevue/mcp"]}' -s user
+primevue-mcp
 ```
 
-**Useful commands:**
+## Setup
+
+### Claude Code
 
 ```bash
-claude mcp list           # List all MCP servers
-claude mcp get primevue   # Get server details
-claude mcp remove primevue # Remove the server
+claude mcp add primevue -s user -- npx -y @primevue/mcp@alpha
 ```
 
-After adding, start a new Claude Code session and use `/mcp` to verify the connection.
-
-> **Reference:** [Claude Code MCP Documentation](https://code.claude.com/docs/en/mcp)
+Project-local configuration:
 
----
-
-### Cursor
-
-**Option 1: Project Configuration**
-
-Create `.cursor/mcp.json` in your project:
-
-```json
-{
-    "mcpServers": {
-        "primevue": {
-            "command": "npx",
-            "args": ["-y", "@primevue/mcp"]
-        }
-    }
-}
+```bash
+claude mcp add primevue -- npx -y @primevue/mcp@alpha
 ```
 
-**Option 2: Global Configuration**
+### Cursor
 
-Create or edit `~/.cursor/mcp.json` in your home directory:
+Create `.cursor/mcp.json` in your project or edit `~/.cursor/mcp.json`:
 
 ```json
 {
     "mcpServers": {
         "primevue": {
             "command": "npx",
-            "args": ["-y", "@primevue/mcp"]
+            "args": ["-y", "@primevue/mcp@alpha"]
         }
     }
 }
 ```
 
-**Option 3: Via Settings UI**
-
-1. Go to **Cursor Settings** > **Tools & Integrations**
-2. Click **New MCP Server**
-3. Add the configuration above
-
-After adding, go to **Settings > MCP** and click the refresh button. The Composer Agent will automatically use PrimeVue tools when relevant.
-
-> **Reference:** [Cursor MCP Documentation](https://docs.cursor.com/context/model-context-protocol)
-
----
-
-### VS Code (GitHub Copilot)
-
-**Option 1: Project Configuration**
+### VS Code
 
 Create `.vscode/mcp.json` in your project:
 
@@ -95,228 +52,69 @@ Create `.vscode/mcp.json` in your project:
     "servers": {
         "primevue": {
             "command": "npx",
-            "args": ["-y", "@primevue/mcp"]
+            "args": ["-y", "@primevue/mcp@alpha"]
         }
     }
 }
 ```
 
-**Option 2: User Configuration (Global)**
+For user-level setup, place the same `servers` object in your VS Code user MCP configuration.
 
-Create or edit the MCP configuration file in your VS Code user data directory:
-
-- **macOS**: `~/Library/Application Support/Code/User/mcp.json`
-- **Windows**: `%APPDATA%\Code\User\mcp.json`
-- **Linux**: `~/.config/Code/User/mcp.json`
-
-```json
-{
-    "servers": {
-        "primevue": {
-            "command": "npx",
-            "args": ["-y", "@primevue/mcp"]
-        }
-    }
-}
-```
-
-**Option 3: Via Command Palette**
-
-1. Open Command Palette (`Cmd+Shift+P` / `Ctrl+Shift+P`)
-2. Type "MCP: Add Server"
-3. Select "Command (stdio)"
-4. Enter `primevue` as the server ID
-5. Enter `npx` as the command
-6. Enter `-y,@primevue/mcp` as the arguments
-
-After adding, use Copilot in **Agent mode** to access PrimeVue tools. The MCP server will be available in GitHub Copilot Chat.
-
-> **Reference:** [VS Code MCP Documentation](https://code.visualstudio.com/docs/copilot/chat/mcp-servers)
-
----
-
-### OpenAI Codex CLI
-
-**Option 1: Using the CLI**
+### Codex
 
 ```bash
-codex mcp add primevue -- npx -y @primevue/mcp
+codex mcp add primevue -- npx -y @primevue/mcp@alpha
 ```
 
-**Option 2: Direct Configuration**
-
-Edit `~/.codex/config.toml`:
+Or edit `~/.codex/config.toml`:
 
 ```toml
 [mcp_servers.primevue]
 command = "npx"
-args = ["-y", "@primevue/mcp"]
+args = ["-y", "@primevue/mcp@alpha"]
 ```
 
-After adding, the MCP server will be available in both the Codex CLI and VS Code extension.
+## MCP Surface
 
-> **Reference:** [OpenAI Codex MCP Documentation](https://developers.openai.com/codex/mcp/)
+The server exposes only the compact shared v2 tool surface:
 
----
+| Tool             | Purpose                                                                     |
+| ---------------- | --------------------------------------------------------------------------- |
+| `list`           | List generated components, guides, examples, resources, or modes.           |
+| `search`         | Search generated component, guide, section, API, and example text.          |
+| `get_component`  | Read component docs and metadata.                                           |
+| `get_guide`      | Read generated guide docs and metadata.                                     |
+| `get_example`    | Return one source-backed example from generated component docs.             |
+| `get_setup`      | Return setup guidance from generated installation docs.                     |
+| `validate_usage` | Validate component usage against generated API metadata.                    |
+| `version`        | Return server, docs data, tool, resource, and known manual metadata status. |
 
-### Windsurf
+Generated docs are exposed through resources and templates:
 
-**Option 1: Via Settings UI**
+- Static resources: `primeui://primevue/index.json`, `primeui://primevue/llms.txt`, `primeui://primevue/llms-full.txt`
+- Resource templates: `component-docs`, `component-api`, `example-docs`, `guide-docs`
 
-1. Click **Windsurf - Settings** (bottom right) or press `Cmd+Shift+P` / `Ctrl+Shift+P`
-2. Type "Open Windsurf Settings"
-3. Navigate to **Cascade** section
-4. Click **Manage MCPs** > **View raw config**
+Workflow prompts:
 
-**Option 2: Direct Configuration**
+- `use_component`
+- `build_form`
+- `theme_component`
+- `migrate_primeui`
+- `audit_component_usage`
 
-Edit `~/.codeium/windsurf/mcp_config.json`:
+## Data and Release Assumption
 
-```json
-{
-    "mcpServers": {
-        "primevue": {
-            "command": "npx",
-            "args": ["-y", "@primevue/mcp"]
-        }
-    }
-}
-```
-
-After adding, the MCP server will be available in Cascade.
-
-> **Reference:** [Windsurf MCP Documentation](https://docs.windsurf.com/windsurf/cascade/mcp)
-
----
-
-### Zed
-
-Add to your Zed settings (`~/.config/zed/settings.json` on Linux, `~/Library/Application Support/Zed/settings.json` on macOS):
-
-```json
-{
-    "context_servers": {
-        "primevue": {
-            "command": {
-                "path": "npx",
-                "args": ["-y", "@primevue/mcp"]
-            }
-        }
-    }
-}
-```
+`@primevue/mcp` does not vendor the shared core. For the first alpha, its published dependency on `@primeuix/mcp` is exactly `2.0.0-alpha.1`; do not widen this to `^2.0.0` or `^2.0.0-alpha.1` until the alpha package install path has been validated from the public registry.
 
-After adding, restart Zed. Check the Agent Panel's settings view - a green indicator dot next to "primevue" confirms the server is active.
-
-> **Reference:** [Zed MCP Documentation](https://zed.dev/docs/ai/mcp)
-
----
-
-## Available Tools
-
-### Component Information
-
-| Tool                    | Description                                  |
-| ----------------------- | -------------------------------------------- |
-| `list_components`       | List all PrimeVue components with categories |
-| `get_component`         | Get detailed info about a specific component |
-| `search_components`     | Search components by name or description     |
-| `get_component_props`   | Get all props for a component                |
-| `get_component_events`  | Get all events for a component               |
-| `get_component_methods` | Get all methods for a component              |
-| `get_component_slots`   | Get all slots for a component                |
-| `compare_components`    | Compare two components side by side          |
-| `get_categories`        | Get all component categories                 |
-
-### Code Examples
-
-| Tool                          | Description                                     |
-| ----------------------------- | ----------------------------------------------- |
-| `get_usage_example`           | Get code examples for a component               |
-| `list_examples`               | List all available code examples                |
-| `get_example`                 | Get a specific example by component and section |
-| `generate_component_template` | Generate a basic component template             |
-
-### Theming & Styling
-
-| Tool                    | Description                                    |
-| ----------------------- | ---------------------------------------------- |
-| `get_component_pt`      | Get Pass Through options for DOM customization |
-| `get_component_tokens`  | Get design tokens (CSS variables)              |
-| `get_component_styles`  | Get CSS class names                            |
-| `get_theming_info`      | Get theming information                        |
-| `get_theming_guide`     | Get detailed theming guide                     |
-| `get_passthrough_guide` | Get Pass Through customization guide           |
-| `get_tailwind_guide`    | Get Tailwind CSS integration guide             |
-
-### Documentation & Guides
-
-| Tool                      | Description                             |
-| ------------------------- | --------------------------------------- |
-| `list_guides`             | List all guides and documentation pages |
-| `get_guide`               | Get a specific guide by name            |
-| `get_configuration`       | Get PrimeVue configuration options      |
-| `get_installation`        | Get installation instructions           |
-| `get_icons_guide`         | Get icons usage guide                   |
-| `get_accessibility_guide` | Get accessibility guide                 |
-| `get_accessibility_info`  | Get accessibility info for a component  |
-
-### Search & Discovery
-
-| Tool                           | Description                                 |
-| ------------------------------ | ------------------------------------------- |
-| `search_all`                   | Search across components, guides, and props |
-| `suggest_component`            | Suggest components based on use case        |
-| `find_by_prop`                 | Find components with a specific prop        |
-| `find_by_event`                | Find components that emit a specific event  |
-| `find_components_with_feature` | Find components supporting a feature        |
-| `get_related_components`       | Find related components                     |
-
-### Utilities
-
-| Tool                     | Description                               |
-| ------------------------ | ----------------------------------------- |
-| `get_component_url`      | Get the official documentation URL        |
-| `get_component_import`   | Get the correct import statement          |
-| `get_component_sections` | Get all sections/features for a component |
-| `validate_props`         | Validate props for a component            |
-| `export_component_docs`  | Export documentation in markdown          |
-| `get_form_components`    | Get all form input components             |
-| `get_data_components`    | Get all data display components           |
-| `get_overlay_components` | Get all overlay/popup components          |
-| `get_performance_tips`   | Get performance optimization tips         |
-| `get_version_info`       | Get version and compatibility info        |
-
-### Vue Composables
-
-| Tool               | Description                             |
-| ------------------ | --------------------------------------- |
-| `list_composables` | List all PrimeVue composables           |
-| `get_composable`   | Get details about a specific composable |
-
-## Example Prompts
-
-Once installed, try asking your AI assistant:
-
-- "What are all the props available for the DataTable component?"
-- "Show me how to implement row selection in DataTable"
-- "How do I customize Button styles using Pass Through?"
-- "What design tokens are available for the Card component?"
-- "Find me a component for selecting multiple items from a list"
-- "Compare AutoComplete and Select components"
-
-## Requirements
-
-- Node.js 18+
-- One of the supported AI tools (Claude Code, VS Code + Copilot, Cursor, Windsurf, Claude Desktop)
+The bundled package docs are copied from the generated public `/llms` Markdown files during `build:prebuild`. The public `/llms` files remain the canonical web compatibility surface.
 
 ## Links
 
-- [PrimeVue Documentation](https://primevue.org/)
+- [PrimeVue Documentation](https://primevue.dev/)
 - [Model Context Protocol](https://modelcontextprotocol.io/)
 - [GitHub Repository](https://github.com/primefaces/primevue)
 - [Report Issues](https://github.com/primefaces/primevue/issues)
 
 ## License
 
-MIT
+Licensed under the [PrimeUI License](https://primeui.dev/licenses) - Copyright (c) [PrimeTek Informatics](https://www.primetek.com.tr)