powerbi-visuals-tools 7.1.0 → 7.1.1

package/Changelog.md

@@ -2,11 +2,10 @@
 
 This page contains information about changes to the PowerBI Visual Tools (pbiviz).
 
+## 7.1.1
+* Minor documentation and metadata updates.
+
 ## 7.1.0
-* Added MCP (Model Context Protocol) server support via `pbiviz mcp` command, providing AI-powered tools for visual development.
-* Added MCP tools: available APIs, best practices, certification guidance, visual info, and vulnerabilities detection.
-* Added MCP configuration template for new visuals (`.vscode/mcp.json`).
-* Added unit tests for MCP tools.
 * Updated packages.
 
 ## 7.0.4

package/README.md

@@ -1,7 +1,7 @@
 [![Npm Version](https://img.shields.io/npm/v/powerbi-visuals-tools.svg?style=flat)](https://www.npmjs.com/package/powerbi-visuals-tools)
 [![Npm Downloads](https://img.shields.io/npm/dm/powerbi-visuals-tools.svg?style=flat)](https://www.npmjs.com/package/powerbi-visuals-tools)
 ![Build](https://github.com/microsoft/powerbi-visuals-tools/workflows/build/badge.svg) 
-[![Build status](https://ci.appveyor.com/api/projects/status/ogws5ib33i35o5hs/branch/master?svg=true)](https://ci.appveyor.com/project/spatney/powerbi-visuals-tools)
+[![Build status](https://ci.appveyor.com/api/projects/status/ogws5ib33i35o5hs/branch/main?svg=true)](https://ci.appveyor.com/project/spatney/powerbi-visuals-tools)
 [![Code Climate](https://codeclimate.com/github/Microsoft/PowerBI-visuals-tools/badges/gpa.svg)](https://codeclimate.com/github/Microsoft/PowerBI-visuals-tools)
 
 # PowerBI Visual Tools (pbiviz)
@@ -52,12 +52,12 @@ You can learn more about using these tools in the following guides
 
 ## PowerBI Visuals Tools Changes
 
-* [Change Log](https://github.com/Microsoft/PowerBI-visuals-tools/blob/master/Changelog.md)
+* [Change Log](https://github.com/Microsoft/PowerBI-visuals-tools/blob/main/Changelog.md)
 
 ## Visuals API Changes
 
-* [API Change Log](https://github.com/microsoft/PowerBI-visuals-tools/blob/master/Changelog.md)
+* [API Change Log](https://github.com/microsoft/PowerBI-visuals-tools/blob/main/Changelog.md)
 
 ## Contributing
 
-If you would like to contribute please see [How To Contribute](https://github.com/Microsoft/PowerBI-visuals-tools/blob/master/CONTRIBUTING.md).
+If you would like to contribute please see [How To Contribute](https://github.com/Microsoft/PowerBI-visuals-tools/blob/main/CONTRIBUTING.md).

package/bin/pbiviz.js

@@ -113,7 +113,7 @@ pbiviz
 
 pbiviz
     .command('mcp')
-    .description('Start MCP (Model Context Protocol) server for AI assistant integration')
+    .description('Start MCP (Model Context Protocol) server for AI assistant integration (Preview)')
     .option('--init', 'Initialize MCP configuration in current project (.vscode/mcp.json)')
     .action((options) => {
         if (options.init) {

package/lib/mcp/McpServer.js

@@ -93,6 +93,9 @@ export async function initMcpConfig(rootPath) {
     const vscodeDir = path.join(rootPath, ".vscode");
     const mcpConfigPath = path.join(vscodeDir, "mcp.json");
     try {
+        ConsoleWriter.warning("MCP support in pbiviz is currently in Preview.");
+        ConsoleWriter.info("The command surface, available tools, and configuration format may change in future releases without backward-compatibility guarantees.");
+        ConsoleWriter.blank();
         // Check if mcp.json already exists
         if (fs.existsSync(mcpConfigPath)) {
             ConsoleWriter.warning("MCP configuration already exists at .vscode/mcp.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "powerbi-visuals-tools",
-  "version": "7.1.0",
+  "version": "7.1.1",
   "description": "Command line tool for creating and publishing visuals for Power BI",
   "main": "./bin/pbiviz.js",
   "type": "module",
@@ -48,6 +48,7 @@
     "lodash.isequal": "4.5.0",
     "lodash.ismatch": "^4.4.0",
     "mini-css-extract-plugin": "^2.10.2",
+    "powerbi-visuals-api": "~5.3.0",
     "powerbi-visuals-webpack-plugin": "^5.0.1",
     "terser-webpack-plugin": "^5.4.0",
     "ts-loader": "^9.5.4",
@@ -56,7 +57,6 @@
     "webpack-bundle-analyzer": "4.10.2",
     "webpack-dev-server": "^5.2.3",
     "zod": "^4.3.6"
-
   },
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "^8.58.0",

package/MCP.md

@@ -1,234 +0,0 @@
-# Power BI Visuals Tools - MCP Server
-
-This document describes the MCP (Model Context Protocol) server integration for Power BI Custom Visual Tools, inspired by the Angular 21 MCP implementation.
-
-## What is MCP?
-
-Model Context Protocol (MCP) is an open protocol that allows AI assistants (like GitHub Copilot, Cursor, Claude) to interact with development tools directly. The MCP server exposes "tools" that AI can call to get context-aware information about your project.
-
-## Quick Start
-
-### Option 1: Using VS Code with Copilot
-
-1. Add this to your VS Code settings or create `.vscode/mcp.json`:
-
-```json
-{
-    "servers": {
-        "pbiviz": {
-            "command": "npx",
-            "args": ["-y", "powerbi-visuals-tools", "mcp"]
-        }
-    }
-}
-```
-
-2. Restart VS Code
-3. In Copilot Chat, you can now ask questions like:
-   - "Check my visual for certification readiness"
-   - "What are the best practices for Power BI visuals?"
-   - "Show me available Power BI Visual APIs"
-
-### Option 2: Using Cursor
-
-Add to Cursor settings (`~/.cursor/mcp.json`):
-
-```json
-{
-    "mcpServers": {
-        "pbiviz": {
-            "command": "npx",
-            "args": ["-y", "powerbi-visuals-tools", "mcp"]
-        }
-    }
-}
-```
-
-### Option 3: Run Manually (for testing)
-
-```bash
-cd /path/to/your/visual-project
-pbiviz mcp
-```
-
-The server runs on STDIO, so you won't see output, but it will respond to MCP requests.
-
-## Available Tools
-
-| Tool | Description | Local | Read-only |
-|------|-------------|-------|-----------|
-| `get_best_practices` | Returns best practice guidelines for Power BI visual development | ✅ | ✅ |
-| `check_vulnerabilities` | Scans project for security vulnerabilities in dependencies and code | ✅ | ✅ |
-| `prepare_certification` | Audits visual for Power BI certification readiness | ✅ | ✅ |
-| `list_visual_info` | Returns info about current visual (name, GUID, API version, capabilities) | ✅ | ✅ |
-| `get_available_apis` | Lists available Power BI Visual APIs with examples | ✅ | ✅ |
-
-### Tool Details
-
-#### `get_best_practices`
-
-Returns comprehensive guidelines including:
-- API version management
-- Performance optimization tips
-- Security guidelines
-- Accessibility requirements
-- Project structure recommendations
-- Testing best practices
-
-#### `check_vulnerabilities`
-
-Analyzes:
-- `package.json` dependencies for known vulnerable packages
-- Source code for dangerous patterns (`eval()`, `innerHTML`, external fetch calls)
-- Returns severity-categorized results (critical/high/medium/low/info)
-
-#### `prepare_certification`
-
-Checks:
-- Required files (pbiviz.json, capabilities.json, package.json)
-- Visual configuration (name, GUID, version format, API version)
-- Capabilities (data roles, accessibility support)
-- Assets (icon.png)
-
-#### `list_visual_info`
-
-Extracts from project files:
-- Visual name, display name, GUID
-- Version and API version
-- Author information
-- Defined data roles and format objects
-- Supported features (highlight, keyboard focus, etc.)
-- Dependencies list
-
-#### `get_available_apis`
-
-Provides documentation for:
-- **Data APIs**: fetchMoreData, persistProperties
-- **Formatting APIs**: colorPalette, getFormattingModel, high contrast
-- **Interaction APIs**: selectionManager, tooltipService, contextMenu, drilldown
-- **Utility APIs**: localization, storage, events, modal dialog
-
-Accepts optional `category` parameter: `data`, `formatting`, `interaction`, `utility`, or `all`.
-
-## Example Interactions
-
-### With GitHub Copilot (Agent Mode)
-
-**You:** "Is my visual ready for certification?"
-
-**Copilot:** *calls `prepare_certification` tool*
-
-> Based on the certification check, your visual has:
-> - ✅ 12 passed checks
-> - ⚠️ 2 warnings: Missing keyboard focus support, no README.md
-> - ❌ 1 failed: API version 2.6.0 is outdated
-> 
-> Recommendation: Update to API version 5.x and add `"supportsKeyboardFocus": true` to capabilities.json.
-
----
-
-**You:** "What APIs can I use for tooltips and selection?"
-
-**Copilot:** *calls `get_available_apis` with category="interaction"*
-
-> For tooltips, use `host.tooltipService.show()`:
-> ```typescript
-> host.tooltipService.show({
->     dataItems: tooltipData,
->     coordinates: [x, y]
-> });
-> ```
-> For selection, use `selectionManager`:
-> ```typescript
-> const selectionManager = host.createSelectionManager();
-> selectionManager.select(selectionId);
-> ```
-
-## How It Works
-
-```
-┌─────────────────┐     STDIO      ┌─────────────────┐
-│   VS Code /     │ ◄───────────►  │   pbiviz mcp    │
-│   Copilot       │    (MCP)       │   (MCP Server)  │
-└─────────────────┘                └─────────────────┘
-                                          │
-                                          ▼
-                                   ┌─────────────────┐
-                                   │  Visual Project │
-                                   │  - pbiviz.json  │
-                                   │  - capabilities │
-                                   │  - package.json │
-                                   │  - src/         │
-                                   └─────────────────┘
-```
-
-1. VS Code starts `pbiviz mcp` as a subprocess
-2. Copilot sends `ListTools` request → pbiviz returns available tools
-3. When you ask a question, Copilot may call a tool
-4. pbiviz executes the tool (reads project files, runs checks)
-5. Results are returned to Copilot as structured text
-6. Copilot presents the information in a helpful way
-
-## Development
-
-### Building from Source
-
-```bash
-git clone https://github.com/Microsoft/PowerBI-visuals-tools.git
-cd PowerBI-visuals-tools
-npm install
-npm run build
-```
-
-### Testing MCP Server Locally
-
-```bash
-# In your visual project directory:
-node /path/to/PowerBI-visuals-tools/bin/pbiviz.js mcp
-```
-
-### Adding New Tools
-
-1. Create a new file in `src/mcp/tools/`
-2. Export a function that returns a string result
-3. Register the tool in `src/mcp/McpServer.ts`
-
-Example:
-```typescript
-// src/mcp/tools/myTool.ts
-export function myTool(rootPath: string): string {
-    // Read files, perform checks, return markdown result
-    return "# My Tool Result\n...";
-}
-
-// In McpServer.ts
-this.server.tool(
-    "my_tool",
-    "Description for AI",
-    {},
-    async () => ({
-        content: [{ type: "text", text: myTool(this.rootPath) }]
-    })
-);
-```
-
-## Comparison with Angular 21 MCP
-
-| Feature | Angular CLI | pbiviz (this implementation) |
-|---------|-------------|------------------------------|
-| Best practices | `get_best_practices` | `get_best_practices` |
-| Project info | `list_projects` | `list_visual_info` |
-| Code examples | `find_examples` | `get_available_apis` |
-| Documentation search | `search_documentation` (online) | ❌ (offline only) |
-| Migration tools | `onpush_zoneless_migration` | `prepare_certification` |
-| Build/Run | `build`, `serve` | Use regular CLI commands |
-
-## Requirements
-
-- Node.js >= 18.0.0
-- VS Code with GitHub Copilot (for Chat integration)
-- Or Cursor / other MCP-compatible AI assistant
-
-## License
-
-MIT - Microsoft Corporation