metabase-ai-assistant 4.0.0 → 4.2.0

package/README.md

@@ -4,7 +4,7 @@
 
 ### **The Most Powerful MCP Server for Metabase**
 
-**111+ Tools** • **AI-Powered SQL** • **Enterprise Security** • **Zero Config**
+**134 Tools** • **MCP SDK v1.26.0** • **AI-Powered SQL** • **Structured Output** • **Enterprise Security**
 
 [![npm version](https://img.shields.io/npm/v/metabase-ai-assistant.svg?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/metabase-ai-assistant)
 [![npm downloads](https://img.shields.io/npm/dm/metabase-ai-assistant.svg?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/metabase-ai-assistant)
@@ -15,7 +15,7 @@
 [![Claude](https://img.shields.io/badge/Claude-Ready-orange.svg?style=flat-square)](https://claude.ai)
 [![Cursor](https://img.shields.io/badge/Cursor-Ready-green.svg?style=flat-square)](https://cursor.sh)
 [![Node.js](https://img.shields.io/badge/Node.js-18+-brightgreen.svg?style=flat-square&logo=node.js)](https://nodejs.org/)
-
+[![MCP Badge](https://lobehub.com/badge/mcp/onmartech-metabase-ai-assistant)](https://lobehub.com/mcp/onmartech-metabase-ai-assistant)
 ---
 
 **Turn your AI assistant into a Metabase power user.**  
@@ -33,7 +33,7 @@ Generate SQL from natural language, create dashboards, manage users, and automat
 
 | Feature | **This Project** | Other MCP Servers |
 |---------|:----------------:|:-----------------:|
-| **Total Tools** | **111+** ✅ | 6-30 |
+| **Total Tools** | **134** ✅ | 6-30 |
 | **AI SQL Generation** | ✅ | ❌ |
 | **AI SQL Optimization** | ✅ | ❌ |
 | **Dashboard Templates** | ✅ | ❌ |
@@ -45,6 +45,8 @@ Generate SQL from natural language, create dashboards, manage users, and automat
 | **Metadata Analytics** | ✅ | ❌ |
 | **Parametric Questions** | ✅ | ❌ |
 | **Environment Comparison** | ✅ | ❌ |
+| **Structured Output (JSON)** | ✅ | ❌ |
+| **Tool Annotations** | ✅ | ❌ |
 
 ---
 
@@ -109,7 +111,9 @@ AI: 🔒 Blocked - Read-only mode active
 
 ---
 
-## 🔧 Complete Tool List (111+)
+## 🔧 Complete Tool List (134)
+
+> 🆕 All tools include MCP annotations and `title`. 16 priority tools support `outputSchema` + `structuredContent` for typed JSON responses.
 
 <details>
 <summary><b>📊 Database Operations (25 tools)</b></summary>
@@ -299,18 +303,17 @@ npm run mcp
 metabase-ai-assistant/
 ├── src/
 │   ├── mcp/
-│   │   ├── server.js          # Main MCP server (111+ tools)
-│   │   └── handlers/          # Modular handlers
-│   │       ├── database.js    # DB operations
-│   │       ├── dashboard.js   # Dashboard ops
-│   │       ├── questions.js   # Question ops
-│   │       └── ai.js          # AI features
+│   │   ├── server.js              # MCP Server entry point
+│   │   ├── tool-registry.js       # 134 tool definitions + annotations + outputSchema
+│   │   ├── tool-router.js         # Dynamic routing with read-only gate
+│   │   └── handlers/              # 15 modular handler files
 │   ├── utils/
-│   │   ├── cache.js           # TTL-based caching
-│   │   ├── config.js          # Zod validation
-│   │   └── response-optimizer.js
+│   │   ├── structured-response.js # Structured output (MCP 2025-06-18)
+│   │   ├── cache.js               # TTL-based caching
+│   │   ├── config.js              # Zod validation
+│   │   └── response-optimizer.js  # Compact response formatting
 │   └── metabase/
-│       └── client.js          # Metabase API client
+│       └── client.js              # Metabase API client
 ```
 
 ---

package/README_MCP.md

@@ -45,7 +45,9 @@ After updating the configuration file, restart your MCP client to load the new s
 
 ---
 
-## Available Tools (111 Total)
+## Available Tools (134 Total)
+
+> 🆕 **MCP SDK v1.26.0** — All tools include annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`) and human-readable `title`. 16 priority tools support `outputSchema` + `structuredContent` for typed JSON responses.
 
 ### Database Operations
 - **db_list**: List all databases in Metabase
@@ -180,6 +182,10 @@ After updating the configuration file, restart your MCP client to load the new s
 ## Features Summary
 
 ### Currently Available
+- **MCP SDK v1.26.0** (Spec 2025-11-25 compliant)
+- **Structured Output** (`outputSchema` + `structuredContent` for 16 tools)
+- **Tool Annotations** (`readOnlyHint`, `destructiveHint`, `idempotentHint`)
+- **Dynamic Tool List** (`listChanged` capability)
 - **Async Query Management** (for long-running queries)
 - **Smart Response Optimization** (no truncation for DDL/definitions)
 - **Table Profiling** (dim/ref table detection)

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "metabase-ai-assistant",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "mcpName": "io.github.enessari/metabase-ai-assistant",
-  "description": "The most powerful MCP Server for Metabase - 111+ tools for AI-powered SQL generation, dashboard automation, user management & enterprise BI. Works with Claude, Cursor, and any MCP-compatible AI.",
+  "description": "The most powerful MCP Server for Metabase - 134 tools with structured output, AI-powered SQL generation, dashboard automation, user management & enterprise BI. MCP SDK v1.26.0 compliant. Works with Claude, Cursor, and any MCP-compatible AI.",
   "main": "src/index.js",
   "type": "module",
   "scripts": {
@@ -76,11 +76,12 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.17.0",
-    "@modelcontextprotocol/sdk": "^1.17.3",
+    "@modelcontextprotocol/sdk": "^1.26.0",
     "axios": "^1.6.5",
     "chalk": "^5.3.0",
     "dotenv": "^16.3.1",
     "express": "^4.18.2",
+    "he": "^1.2.0",
     "inquirer": "^12.9.3",
     "jsonwebtoken": "^9.0.3",
     "mysql2": "^3.14.3",
@@ -88,8 +89,7 @@
     "ora": "^8.0.1",
     "pg": "^8.16.3",
     "winston": "^3.11.0",
-    "zod": "^3.22.4",
-    "he": "^1.2.0"
+    "zod": "^3.22.4"
   },
   "devDependencies": {
     "@types/node": "^20.11.5",