mcp-dataverse 0.3.0 → 0.3.2

package/CAPABILITIES.md

@@ -1,8 +1,8 @@
 # MCP Dataverse Server — Complete Capabilities Reference
 
-> **Version**: 0.2.0 | **API Version**: Dataverse Web API v9.2 | **Transport**: MCP SDK over stdio
+> **Version**: 0.3.1 | **API Version**: Dataverse Web API v9.2 | **Transport**: stdio · HTTP/SSE
 
-50 tools across 22 categories for full Dataverse lifecycle: schema, CRUD, FetchXML, solutions, plugins, audit, files, users, teams, environment variables, and more.
+54 tools across 23 categories for full Dataverse lifecycle: schema, CRUD, FetchXML, solutions, plugins, audit, files, users, teams, environment variables, and more.
 
 ---
 
@@ -91,12 +91,12 @@ Server communicates over **stdio** (MCP SDK `StdioServerTransport`). Connect fro
 
 ```mermaid
 graph LR
-    MCP["MCP Dataverse Server<br/><i>50 tools · 22 categories</i>"]
+    MCP["MCP Dataverse Server<br/><i>54 tools · 23 categories</i>"]
 
     MCP --> AUTH["🔑 Auth (1)"]
     MCP --> META["📋 Metadata (8)"]
     MCP --> QUERY["🔍 Query (3)"]
-    MCP --> CRUD["✏️ CRUD (5)"]
+    MCP --> CRUD["✏️ CRUD (6)"]
     MCP --> REL["🔗 Relations (2)"]
     MCP --> ACT["⚡ Actions & Functions (6)"]
     MCP --> BATCH["📦 Batch (1)"]
@@ -114,6 +114,8 @@ graph LR
     MCP --> VIEWS["👁️ Views (1)"]
     MCP --> FILES["📁 Files (2)"]
     MCP --> ORG["🏢 Org (1)"]
+    MCP --> TEAMS["👥 Teams (1)"]
+    MCP --> ASSIST["🤖 Assistance (4)"]
 ```
 
 All tool handlers validate inputs with **Zod** before calling the `DataverseAdvancedClient`. Auth tokens are cached and refreshed proactively; transient errors (429, 503, 504) are retried with exponential backoff.

package/README.md

@@ -1,59 +1,53 @@
-# MCP Dataverse Server
+# MCP Dataverse
 
-![MCP Dataverse Logo](assets/logo.webp)
+<div align="center">
 
-![Node 20+](https://img.shields.io/badge/Node.js-20%2B-green) ![TypeScript](https://img.shields.io/badge/TypeScript-5.4-blue) ![MCP](https://img.shields.io/badge/MCP-1.0-purple) ![npm](https://img.shields.io/npm/v/mcp-dataverse) ![License: MIT](https://img.shields.io/badge/License-MIT-yellow)
+<img src="assets/logo.webp" alt="MCP Dataverse" width="180" />
 
-MCP server that exposes the Microsoft Dataverse Web API as **50 AI-callable tools** — enabling GitHub Copilot, Claude, and other MCP clients to query, create, and manage Dataverse records without hallucinating schema.
+**The most complete MCP server for Microsoft Dataverse.**
 
-## Install
+54 tools · 4 resources · 10 guided workflows · Zero config auth
 
-### ✅ Recommended — Interactive CLI (VS Code 1.99+)
+[![npm](https://img.shields.io/npm/v/mcp-dataverse)](https://www.npmjs.com/package/mcp-dataverse)
+[![npm downloads](https://img.shields.io/npm/dm/mcp-dataverse)](https://www.npmjs.com/package/mcp-dataverse)
+[![CI](https://github.com/codeurali/mcp-dataverse/actions/workflows/ci.yml/badge.svg)](https://github.com/codeurali/mcp-dataverse/actions/workflows/ci.yml)
+[![Node 20+](https://img.shields.io/badge/Node.js-20%2B-green)](https://nodejs.org)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.4-blue)](https://www.typescriptlang.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
 
-```bash
-npx mcp-dataverse install
-```
+[Install](#install) · [Capabilities](#capabilities) · [Tools](#tools-54) · [Multi-Client Setup](docs/multi-client-setup.md) · [Full Reference](CAPABILITIES.md)
 
-The wizard will:
+</div>
 
-1. Ask for your Dataverse environment URL
-2. Save configuration to `~/.mcp-dataverse/config.json`
-3. Register the server in VS Code and/or VS Code Insiders via `code --add-mcp`
-4. Authenticate with your Microsoft account (device code flow)
+---
 
-After the wizard completes, the server is immediately available in VS Code — open Copilot chat and the 50 Dataverse tools are ready.
+## Why MCP Dataverse?
 
-> **Requires VS Code 1.99+** — the CLI registration uses `code --add-mcp`, introduced in March 2025. If neither `code` nor `code-insiders` is on your PATH, the wizard prints a manual snippet to copy-paste. Custom VS Code profiles are also detected and patched automatically.
+AI agents hallucinate schema, guess column names, and build broken OData queries. This server gives them **real-time access** to your Dataverse environment — schema, records, metadata, solutions — through the Model Context Protocol.
 
----
+- **No Azure AD app registration** — device code flow, zero pre-configuration
+- **Works with any MCP client** — VS Code, Claude, Cursor, Windsurf, Gemini, Codex CLI
+- **Atomic tools** — each tool does one thing well; the AI picks the right one
+- **Structured outputs** — every response returns `{summary, data, suggestions}`
+- **Guardrails** — destructive operations require explicit confirmation
+- **Encrypted tokens** — AES-256-GCM cached credentials, never logged
 
-### Alternative — VS Code Command Palette
+---
 
-1. Press **Ctrl+Shift+P** (or **Cmd+Shift+P** on macOS)
-2. Type **`MCP: Add Server`** → choose **`NPM Package`** → enter **`mcp-dataverse`**
-3. Choose the scope: **User** or **Workspace**
-4. Edit the generated entry to add your environment URL:
+## Install
 
-```jsonc
-{
-  "servers": {
-    "mcp-dataverse": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "mcp-dataverse"],
-      "env": {
-        "MCP_CONFIG_PATH": "/path/to/.mcp-dataverse/config.json"
-      }
-    }
-  }
-}
+```bash
+npx mcp-dataverse install
 ```
 
----
+The interactive wizard configures your environment, registers the server in VS Code, and authenticates your Microsoft account. Done in under 2 minutes.
 
-### Manual (mcp.json)
+> Requires Node.js 20+ and VS Code 1.99+. For other clients (Claude, Cursor, Windsurf…), see [Multi-Client Setup](docs/multi-client-setup.md).
 
-Create or edit `.vscode/mcp.json` (workspace scope) or the user-level `mcp.json` (**Ctrl+Shift+P** → **MCP: Open User Configuration**):
+<details>
+<summary><strong>Manual setup (mcp.json)</strong></summary>
+
+Add to `.vscode/mcp.json` or user-level MCP configuration:
 
 ```jsonc
 {
@@ -70,258 +64,169 @@ Create or edit `.vscode/mcp.json` (workspace scope) or the user-level `mcp.json`
 }
 ```
 
----
-
-## Authentication — automatic, no setup required
-
-**No PAC CLI, no Azure AD app registration, no credentials to configure.**
-
-The server uses Microsoft's device code flow (MSAL Public Client) — the same mechanism used by Power Platform CLI. Zero pre-configuration: just set your environment URL and the server handles the rest.
-
-### First connection — what you'll see
-
-Authentication is triggered on the **first tool call** after the server starts (e.g. asking Copilot _"Who am I in Dataverse?"_). Here is the exact sequence:
-
-**Step 1 — Open the Output panel**
-
-In VS Code: **View → Output** → select **MCP** in the dropdown.
-
-**Step 2 — The sign-in prompt appears**
-
-```
-[mcp-dataverse] First-time authentication required.
-Environment: https://yourorg.crm.dynamics.com
-Open the URL below in your browser to sign in.
-
-[mcp-dataverse] Sign in required
-
-  1. Open https://microsoft.com/devicelogin in your browser
-     (use the browser profile linked to your Power Platform account)
-  2. Paste the code: ABCD-1234  (already copied to your clipboard)
-  3. Sign in with your work account
-```
-
-**Step 3 — Sign in**
-
-1. Open `https://microsoft.com/devicelogin` in the browser/profile linked to your **Power Platform work account**
-2. Paste the code — it's already in your clipboard
-3. Complete Microsoft sign-in with your work account
-
-**Step 4 — Confirmation in the Output panel**
-
-```
-[mcp-dataverse] Authenticated ✓  Token cached — no sign-in needed next time.
-```
-
-The tool call that triggered auth now completes. All 50 tools are ready to use.
-
-> ⏱ The code expires after **5 minutes**. If it times out, retry the tool call — a new code will be generated.
+</details>
 
-> **Why not auto-open the browser?** Consultants often work with multiple browser profiles (personal vs. work). Device code flow intentionally lets _you_ choose the right browser and profile.
-
-### Subsequent launches
-
-The token is cached encrypted (AES-256-GCM) in `~/.mcp-dataverse/`. On all future server starts, renewal is **completely silent** — no prompt, no browser.
-
-You only need to re-authenticate if the refresh token expires (~90 days of inactivity) or you reset it manually:
-
-```bash
-npx mcp-dataverse-auth https://yourorg.crm.dynamics.com
-```
+---
 
-When re-auth is needed, the Output panel shows:
+## Authentication
 
-```
-[mcp-dataverse] Session expired — re-authenticating.
-Open the URL below in your browser to sign in again.
+**No PAC CLI, no app registration, no client secret.** The server uses Microsoft's device code flow (MSAL Public Client).
 
-[mcp-dataverse] Sign in required
-  ...
-```
+1. **First tool call** → a sign-in code appears in the Output panel (`View → Output → MCP`)
+2. Open `https://microsoft.com/devicelogin` → paste the code → sign in with your work account
+3. **Done.** Token is cached encrypted — all future starts are silent
 
-The same device code process applies.
+Re-authentication is only needed after ~90 days of inactivity: `npx mcp-dataverse-auth`
 
 ---
 
-## Prerequisites
+## Capabilities
 
-- Node.js 20+
-- VS Code + GitHub Copilot (Agent mode)
-- A Dataverse environment with a licensed user account
+| Capability | Description |
+|---|---|
+| **54 Tools** | Full Dataverse lifecycle — schema, CRUD, query, FetchXML, batch, search, audit, files, solutions, and more |
+| **4 Resources** | `dataverse://tables`, schema templates, relationship templates, server instructions |
+| **10 Workflows** | Guided multi-step sequences for common tasks (explore schema, create record, bulk operations…) |
+| **Tool Router** | Intent-based tool suggestion — ask what you need, get the right tools |
+| **Progress Notifications** | Real-time progress for paging and batch operations |
+| **HTTP + SSE Transport** | Supports both stdio (default) and HTTP/SSE (`--transport http --port 3001`) |
 
-## Quick Start (< 5 min)
-
-### 1. Clone & install
-
-```bash
-git clone <repo-url> mcp-dataverse && cd mcp-dataverse
-npm install
-```
+---
 
-### 2. Configure
+## Tools (54)
+
+### Core (50 tools)
+
+| Category | Count | Tools |
+|----------|-------|-------|
+| **Metadata** | 8 | List tables, get schema, relationships, option sets, entity keys |
+| **Query** | 3 | OData query, FetchXML, paginated retrieval |
+| **CRUD** | 6 | Get, create, update, delete, upsert, assign |
+| **Relations** | 2 | Associate, disassociate |
+| **Actions & Functions** | 6 | Execute bound/unbound actions and functions, dependency checks |
+| **Batch** | 1 | Up to 1000 operations in a single atomic request |
+| **Solutions** | 3 | List solutions, components, publish customizations |
+| **Customization** | 3 | Custom actions, plugin steps, workflow state |
+| **Search** | 1 | Dataverse Relevance Search (full-text) |
+| **Audit** | 1 | Record change history |
+| **Trace** | 2 | Plugin trace logs, workflow execution logs |
+| **Environment** | 2 | Get/set environment variables |
+| **Users & Teams** | 3 | List users, roles, teams |
+| **Files** | 2 | Upload/download file and image columns |
+| **Annotations** | 2 | Notes and attachments (read + create) |
+| **Views** | 1 | System and personal saved views |
+| **Org** | 1 | Business units hierarchy |
+| **Tracking** | 1 | Delta change detection with tokens |
+| **Impersonation** | 1 | Execute any tool on behalf of another user |
+| **Quality** | 1 | Duplicate detection |
+| **Auth** | 1 | WhoAmI connection verification |
+
+### Assistance (4 tools)
+
+| Tool | Purpose |
+|------|---------|
+| `dataverse_suggest_tools` | Describe your intent → get the right tools with usage examples |
+| `dataverse_list_tool_tags` | Browse all tools by category tag |
+| `dataverse_list_workflows` | List available guided workflows |
+| `dataverse_get_workflow` | Get step-by-step instructions for a specific workflow |
+
+> Full schema and parameter details → [CAPABILITIES.md](CAPABILITIES.md)
 
-```bash
-cp config.example.json config.json
-```
+---
 
-Edit `config.json`:
+## Architecture
 
-| Field              | Description                                           |
-| ------------------ | ----------------------------------------------------- |
-| `environmentUrl`   | Your org URL, e.g. `https://yourorg.crm.dynamics.com` |
-| `requestTimeoutMs` | HTTP timeout in ms (default: `30000`)                 |
-| `maxRetries`       | Retry count on transient errors (default: `3`)        |
+```mermaid
+flowchart LR
+    CLIENT["MCP Client\nCopilot · Claude · Cursor · Windsurf…"]
 
-### 3. Authenticate
+    CLIENT -->|stdio / HTTP+SSE| SERVER
 
-```bash
-npm run auth:setup
-```
+    subgraph SERVER["MCP Server"]
+        direction TB
+        REGISTRY["Tool Registry — O(1) dispatch"]
+        TOOLS["54 Tools · 4 Resources"]
+        GUARD["Guardrails · Annotations · Structured Outputs"]
+    end
 
-Runs device code authentication. Follow the URL printed to the terminal — sign in with your Power Platform account. Token is cached and silently renewed.
+    SERVER --> HTTP
 
-### 4. Build
+    subgraph HTTP["HTTP Layer"]
+        direction TB
+        HTTPC["HttpClient — native fetch · retry · timeout"]
+        AUTH["AuthProvider — MSAL device code flow"]
+    end
 
-```bash
-npm run build
+    HTTP --> API["Dataverse\nWeb API v9.2"]
 ```
 
-### 5. Verify the connection
+**Stack**: TypeScript strict · Node.js 20+ · Zod validation · 459 tests · GitHub Actions CI
 
-```bash
-npx tsx tests/live/test-whoami.ts
-```
-
-Expected output:
-
-```
-WhoAmI result: { UserId: 'xxxxxxxx-...', BusinessUnitId: 'xxxxxxxx-...', OrganizationId: 'xxxxxxxx-...' }
-```
+---
 
-### 6. Configure VS Code
+## Configuration
 
-`.vscode/mcp.json` is already present in this repo. If you need to add it manually:
+`~/.mcp-dataverse/config.json` (created by the install wizard):
 
 ```json
 {
-  "servers": {
-    "dataverse": {
-      "type": "stdio",
-      "command": "node",
-      "args": ["${workspaceFolder}/dist/server.js"],
-      "env": {}
-    }
-  }
+  "environmentUrl": "https://yourorg.crm.dynamics.com",
+  "requestTimeoutMs": 30000,
+  "maxRetries": 3
 }
 ```
 
-1. Restart VS Code
-2. Open GitHub Copilot chat → switch to **Agent mode** (⚡)
-3. Test: _"List the Dataverse tables in my environment"_
+Config resolution: `MCP_CONFIG_PATH` env var → `~/.mcp-dataverse/config.json` → `./config.json`
 
 ---
 
-## Tools (50)
-
-| Tool                                         | Category      | Description                                                                         |
-| -------------------------------------------- | ------------- | ----------------------------------------------------------------------------------- |
-| `dataverse_whoami`                           | Auth          | Verify connection; returns UserId, BusinessUnitId, OrgId                            |
-| `dataverse_list_tables`                      | Metadata      | List all tables (`customOnly` filter available)                                     |
-| `dataverse_get_table_metadata`               | Metadata      | Full schema: columns, types, logical names                                          |
-| `dataverse_get_relationships`                | Metadata      | All 1:N, N:1, N:N relationships for a table; filter by `relationshipType`           |
-| `dataverse_list_global_option_sets`          | Metadata      | All global option sets in the environment                                           |
-| `dataverse_get_option_set`                   | Metadata      | Options and values for a specific option set                                        |
-| `dataverse_get_entity_key`                   | Metadata      | Alternate key definitions for a table (fields, index status, customizable flag)     |
-| `dataverse_query`                            | Query         | OData query with `$select`, `$filter`, `$orderby`, `$expand`, `$count`              |
-| `dataverse_execute_fetchxml`                 | Query         | Raw FetchXML for aggregations and complex joins                                     |
-| `dataverse_retrieve_multiple_with_paging`    | Query         | Paginated query following `@odata.nextLink`, with configurable `maxTotal` cap       |
-| `dataverse_get`                              | CRUD          | Retrieve a single record by GUID                                                    |
-| `dataverse_create`                           | CRUD          | Create a record; returns the new GUID                                               |
-| `dataverse_update`                           | CRUD          | Patch a record — only specified fields are changed                                  |
-| `dataverse_delete`                           | CRUD          | Delete a record (requires explicit confirm)                                         |
-| `dataverse_upsert`                           | CRUD          | Create-or-update via alternate key                                                  |
-| `dataverse_assign`                           | CRUD          | Assign a record to a different user or team owner                                   |
-| `dataverse_associate`                        | Relations     | Associate two records via a named relationship                                      |
-| `dataverse_disassociate`                     | Relations     | Remove an association between two records                                           |
-| `dataverse_execute_action`                   | Actions       | Execute a global (unbound) Dataverse action                                         |
-| `dataverse_execute_function`                 | Actions       | Execute a global read-only function (e.g. `WhoAmI`)                                 |
-| `dataverse_execute_bound_action`             | Actions       | Execute an action bound to a specific record                                        |
-| `dataverse_execute_bound_function`           | Actions       | Execute an OData bound function on a specific record                                |
-| `dataverse_retrieve_dependencies_for_delete` | Actions       | Check what components block deletion of a Dataverse component                       |
-| `dataverse_list_dependencies`                | Actions       | List component dependencies before modifying or deleting                            |
-| `dataverse_batch_execute`                    | Batch         | Up to 1000 operations in a single HTTP batch request; optional atomic changeset     |
-| `dataverse_change_detection`                 | Tracking      | Delta tracking using change tokens to detect record changes since last sync         |
-| `dataverse_solution_components`              | Solution      | List all components in a named solution; filter by component type code              |
-| `dataverse_publish_customizations`           | Solution      | Publish pending customizations (all or targeted entities/web resources/option sets) |
-| `dataverse_impersonate`                      | Impersonation | Execute any tool on behalf of another Dataverse user via `MSCRMCallerId`            |
-| `dataverse_list_custom_actions`              | Customization | Lists custom actions (custom API / SDK messages) in the environment                 |
-| `dataverse_list_plugin_steps`                | Customization | Lists plugin step registrations with stage, mode, entity, and state                 |
-| `dataverse_get_environment_variable`         | Environment   | Retrieve an environment variable definition and current value                       |
-| `dataverse_set_environment_variable`         | Environment   | Set or update an environment variable value                                         |
-| `dataverse_get_plugin_trace_logs`            | Trace         | Retrieve plugin execution trace logs for debugging                                  |
-| `dataverse_get_workflow_trace_logs`          | Trace         | Retrieve async workflow/system job execution logs                                   |
-| `dataverse_search`                           | Search        | Full-text Relevance Search across all configured tables                             |
-| `dataverse_get_audit_log`                    | Audit         | Retrieve audit trail for a record showing change history                            |
-| `dataverse_detect_duplicates`                | Quality       | Check for potential duplicates before creating a record                             |
-| `dataverse_get_annotations`                  | Annotations   | Retrieve notes and file attachments linked to a record                              |
-| `dataverse_list_users`                       | Users         | Search system users by name or email with BU filtering                              |
-| `dataverse_get_user_roles`                   | Users         | Security roles assigned to a system user                                            |
-| `dataverse_create_annotation`                | Annotations   | Create a note or file attachment linked to a record                                 |
-| `dataverse_get_attribute_option_set`         | Metadata      | Local/entity-specific option set values (statecode, statuscode, picklist)           |
-| `dataverse_list_solutions`                   | Solution      | List all solutions in the environment                                               |
-| `dataverse_set_workflow_state`               | Customization | Enable or disable a workflow or process                                             |
-| `dataverse_list_views`                       | Views         | List system and personal saved views for a table                                    |
-| `dataverse_upload_file_column`               | Files         | Upload binary content to a file/image column on a record                            |
-| `dataverse_download_file_column`             | Files         | Download binary content from a file/image column on a record                        |
-| `dataverse_list_business_units`              | Org           | List business units in the environment (org hierarchy)                              |
-| `dataverse_list_teams`                       | Teams         | List Dataverse teams with optional filter by team type                              |
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `npx mcp-dataverse install` | Interactive setup wizard |
+| `npx mcp-dataverse doctor` | Diagnose configuration and connectivity issues |
+| `npx mcp-dataverse-auth [url]` | Re-authenticate or switch environment |
+| `npx mcp-dataverse --transport http --port 3001` | Start with HTTP/SSE transport |
 
 ---
 
-## Scripts
+## Security
 
-| Command                    | Description                         |
-| -------------------------- | ----------------------------------- |
-| `npm run build`            | Compile TypeScript → `dist/`        |
-| `npm run dev`              | Watch mode — no build step needed   |
-| `npm start`                | Start the compiled server           |
-| `npm run auth:setup`       | One-time device code authentication |
-| `npm run typecheck`        | Type-check without emitting output  |
-| `npm run lint`             | ESLint on `src/`                    |
-| `npm run test:unit`        | Unit tests only                     |
-| `npm run test:integration` | Integration tests                   |
-| `npm test`                 | All tests                           |
+- **Zero credentials in code** — device code flow, no client secrets
+- **Encrypted token cache** — AES-256-GCM in `~/.mcp-dataverse/`
+- **Tokens never logged** — only diagnostic messages on stderr
+- **Destructive guardrails** — delete operations require explicit `confirm: true`
+- **User-scoped access** — no privilege escalation beyond the authenticated user
+- **Zod validation** — all tool inputs validated at the boundary
 
 ---
 
-## Architecture
-
-TypeScript MCP server over **stdio** transport. The `DeviceCodeAuthProvider` (MSAL device code flow) injects Bearer tokens into a native-`fetch`-based `HttpClient` wrapped by `DataverseClient`. Each tool module registers handlers with the MCP `Server` instance.
+## Troubleshooting
 
-```
-GitHub Copilot → stdio → MCP Server → Tool Router → DataverseClient → Dataverse Web API v9.2
-                                                           └── DeviceCodeAuthProvider (MSAL)
-```
+| Symptom | Fix |
+|---------|-----|
+| No sign-in prompt | Open **View → Output → MCP** — the device code is displayed there |
+| `No MSAL accounts found` | Run `npx mcp-dataverse-auth` then restart the server |
+| `Authentication timed out` | The 5-minute window expired — restart the MCP server for a new code |
+| Server not appearing in Agent mode | Run `npx mcp-dataverse install` or `npx mcp-dataverse doctor` |
+| HTTP errors | Run `npx mcp-dataverse doctor` to check config, auth, and connectivity |
 
 ---
 
-## Security
+## Contributing
 
-- **Never commit `config.json`** — it is in `.gitignore`
-- Token cache (`~/.mcp-dataverse/`) is encrypted (AES-256-GCM) and should not be shared
-- Tokens are never logged; only diagnostic messages are written to stderr
-- Tokens are scoped to the authenticated user — no privilege escalation
+```bash
+git clone https://github.com/codeurali/mcp-dataverse.git && cd mcp-dataverse
+npm install
+npm run build
+npm test          # 459 tests across 38 suites
+npm run lint      # ESLint strict
+npm run typecheck # TypeScript strict mode
+```
 
 ---
 
-## Troubleshooting
+## License
 
-| Symptom                                    | Fix                                                                              |
-| ------------------------------------------ | -------------------------------------------------------------------------------- |
-| No sign-in prompt appeared                 | Open **View → Output → MCP** in VS Code — the device code is displayed there     |
-| Browser didn't open automatically          | Copy the URL from the Output panel manually: `https://microsoft.com/devicelogin` |
-| `No MSAL accounts found`                   | Run `npx mcp-dataverse-auth` to re-authenticate, then restart the server         |
-| `Authentication timed out`                 | The 5-minute window expired — restart the MCP server to get a new code           |
-| `"https://" is required`                   | Check your `~/.mcp-dataverse/config.json` — URL must start with `https://`       |
-| Server not appearing in Copilot Agent mode | Re-run `npx mcp-dataverse install`; check **Output → MCP** panel for errors     |
-| Install wizard says "not found on PATH"    | Install VS Code Shell Command (**Ctrl+Shift+P** → *Shell Command: Install...*) or use the manual snippet provided |
+[MIT](LICENSE) © [codeurali](https://github.com/codeurali)

package/dist/resources/resource-provider.d.ts

@@ -0,0 +1,11 @@
+import type { Resource, ResourceTemplate } from "@modelcontextprotocol/sdk/types.js";
+import type { DataverseAdvancedClient } from "../dataverse/dataverse-client-advanced.js";
+export interface ResourceContent {
+    uri: string;
+    mimeType: string;
+    text: string;
+}
+export declare function listResources(): Resource[];
+export declare function listResourceTemplates(): ResourceTemplate[];
+export declare function readResource(uri: string, client: DataverseAdvancedClient, serverInstructions: string): Promise<ResourceContent>;
+//# sourceMappingURL=resource-provider.d.ts.map

package/dist/resources/resource-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-provider.d.ts","sourceRoot":"","sources":["../../src/resources/resource-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AA8EzF,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,aAAa,IAAI,QAAQ,EAAE,CAE1C;AAED,wBAAgB,qBAAqB,IAAI,gBAAgB,EAAE,CAE1D;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,uBAAuB,EAC/B,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAAC,eAAe,CAAC,CAoB1B"}

package/dist/resources/resource-provider.js

@@ -0,0 +1,79 @@
+// ── Resource Templates (dynamic URIs with parameters) ────────────────────────
+const RESOURCE_TEMPLATES = [
+    {
+        uriTemplate: "dataverse://tables/{tableName}/schema",
+        name: "Table Schema",
+        description: "Returns the full schema (columns, types, requirements) for a Dataverse table",
+        mimeType: "application/json",
+    },
+    {
+        uriTemplate: "dataverse://tables/{tableName}/relationships",
+        name: "Table Relationships",
+        description: "Returns all 1:N and N:N relationships for a Dataverse table",
+        mimeType: "application/json",
+    },
+];
+// ── Static Resources (fixed URIs) ────────────────────────────────────────────
+const STATIC_RESOURCES = [
+    {
+        uri: "dataverse://tables",
+        name: "Available Tables",
+        description: "Lists all custom tables in the connected Dataverse environment",
+        mimeType: "application/json",
+    },
+    {
+        uri: "dataverse://server/instructions",
+        name: "Server Instructions",
+        description: "Usage guidelines and best practices for interacting with this Dataverse MCP server",
+        mimeType: "text/plain",
+    },
+];
+function parseResourceUri(uri) {
+    const PREFIX = "dataverse://";
+    if (!uri.startsWith(PREFIX)) {
+        throw new Error(`Unknown resource URI: ${uri}`);
+    }
+    const path = uri.slice(PREFIX.length);
+    if (path === "tables") {
+        return { type: "tables" };
+    }
+    if (path === "server/instructions") {
+        return { type: "instructions" };
+    }
+    const schemaMatch = /^tables\/([^/]+)\/schema$/.exec(path);
+    if (schemaMatch) {
+        return { type: "schema", tableName: schemaMatch[1] };
+    }
+    const relMatch = /^tables\/([^/]+)\/relationships$/.exec(path);
+    if (relMatch) {
+        return { type: "relationships", tableName: relMatch[1] };
+    }
+    throw new Error(`Unknown resource URI: ${uri}`);
+}
+export function listResources() {
+    return STATIC_RESOURCES;
+}
+export function listResourceTemplates() {
+    return RESOURCE_TEMPLATES;
+}
+export async function readResource(uri, client, serverInstructions) {
+    const parsed = parseResourceUri(uri);
+    switch (parsed.type) {
+        case "tables": {
+            const tables = await client.listTables(true);
+            return { uri, mimeType: "application/json", text: JSON.stringify(tables, null, 2) };
+        }
+        case "schema": {
+            const metadata = await client.getTableMetadata(parsed.tableName);
+            return { uri, mimeType: "application/json", text: JSON.stringify(metadata, null, 2) };
+        }
+        case "relationships": {
+            const rels = await client.getRelationships(parsed.tableName);
+            return { uri, mimeType: "application/json", text: JSON.stringify(rels, null, 2) };
+        }
+        case "instructions": {
+            return { uri, mimeType: "text/plain", text: serverInstructions };
+        }
+    }
+}
+//# sourceMappingURL=resource-provider.js.map

package/dist/resources/resource-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-provider.js","sourceRoot":"","sources":["../../src/resources/resource-provider.ts"],"names":[],"mappings":"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"}