convex-mcp-visual 1.0.2 → 1.0.4

package/README.md

@@ -238,36 +238,45 @@ Check your client's MCP server status panel.
 
 ## Setup
 
-### 1. Convex Authentication
+### 1. Get Your Deploy Key (Required)
 
-You need valid Convex credentials. The server checks these locations in order:
+You need a **deploy key** from the Convex dashboard. This is different from `npx convex login`.
 
-| Priority | Source | How to Set |
-|----------|--------|------------|
-| 1 | `CONVEX_DEPLOY_KEY` env var | `export CONVEX_DEPLOY_KEY=prod:xxx` |
-| 2 | `CONVEX_URL` env var | `export CONVEX_URL=https://xxx.convex.cloud` |
-| 3 | `~/.convex/config.json` | Run `npx convex login` |
+**Step-by-step:**
 
-**Recommended for local development:**
+1. Go to [dashboard.convex.dev](https://dashboard.convex.dev)
+2. Select your project
+3. Click **Settings** (gear icon)
+4. Click **Deploy Keys** in the sidebar
+5. Click **Generate Deploy Key**
+6. Choose "Development" or "Production"
+7. Copy the key (format: `prod:happy-animal-123|convex_deploy_abc123...`)
 
-```bash
-# Login to Convex (creates ~/.convex/config.json)
-npx convex login
+### 2. Add MCP Server with Deploy Key
 
-# Navigate to your Convex project directory
-cd your-convex-project
+**For Claude Code:**
 
-# Deploy your project (optional, updates local config)
-npx convex dev
+```bash
+claude mcp add convex-visual -e CONVEX_DEPLOY_KEY=prod:your-deployment|your-key-here -- npx convex-mcp-visual --stdio
 ```
 
-**For CI/CD or servers:**
+**For Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
 
-```bash
-export CONVEX_DEPLOY_KEY=prod:your-deploy-key-here
+```json
+{
+  "mcpServers": {
+    "convex-visual": {
+      "command": "npx",
+      "args": ["convex-mcp-visual", "--stdio"],
+      "env": {
+        "CONVEX_DEPLOY_KEY": "prod:your-deployment|your-key-here"
+      }
+    }
+  }
+}
 ```
 
-### 2. Verify Installation
+### 3. Verify Installation
 
 ```bash
 # Check MCP server is registered
@@ -621,12 +630,24 @@ claude mcp add convex-visual -- node /full/path/to/dist/index.js --stdio
 
 ### "No Convex deployment configured"
 
+You need to set `CONVEX_DEPLOY_KEY`. See [Setup](#setup) for how to get a deploy key.
+
 ```bash
-# Login to Convex
-npx convex login
+# Re-add MCP server with your deploy key
+claude mcp remove convex-visual
+claude mcp add convex-visual -e CONVEX_DEPLOY_KEY=prod:your-deployment|your-key -- npx convex-mcp-visual --stdio
+```
+
+### "403 Forbidden" or "Connection failed"
 
-# Or set environment variable
-export CONVEX_URL=https://your-deployment.convex.cloud
+This means authentication failed. Common causes:
+1. **Missing or invalid deploy key** - Get a new one from [Convex Dashboard](https://dashboard.convex.dev) → Settings → Deploy Keys
+2. **Wrong format** - Deploy key should be `prod:deployment-name|convex_deploy_xxx...`
+3. **Expired key** - Generate a new deploy key
+
+```bash
+# Test your connection
+CONVEX_DEPLOY_KEY=your-key-here npx convex-mcp-visual --test
 ```
 
 ### Browser doesn't open
@@ -637,11 +658,11 @@ export CONVEX_URL=https://your-deployment.convex.cloud
 
 ### Authentication errors
 
-```bash
-# Clear credentials and re-login
-npx convex logout
-npx convex login
-```
+Get a new deploy key from the Convex Dashboard:
+1. Go to [dashboard.convex.dev](https://dashboard.convex.dev)
+2. Select your project → Settings → Deploy Keys
+3. Generate a new key
+4. Update your MCP server configuration
 
 ### Windows users
 

package/dist/convex-client.d.ts

@@ -2,7 +2,7 @@
  * Convex Client Wrapper
  *
  * Handles authentication and communication with Convex Cloud.
- * Reads credentials from ~/.convex/ or CONVEX_DEPLOY_KEY.
+ * Uses Convex system APIs to fetch schema information.
  */
 export interface TableInfo {
     name: string;
@@ -32,15 +32,20 @@ export interface ConnectionTestResult {
     error?: string;
 }
 export declare class ConvexClient {
-    private client;
     private deploymentUrl;
+    private adminKey;
     constructor();
     private initialize;
     isConnected(): boolean;
     getDeploymentUrl(): string | null;
+    private fetchConvex;
     testConnection(): Promise<ConnectionTestResult>;
     listTables(): Promise<TableInfo[]>;
     getTableSchema(tableName: string): Promise<TableSchema>;
+    private parseShapeToFields;
+    private shapeToTypeString;
+    private parseDocumentTypeToFields;
+    private docTypeToString;
     queryDocuments(tableName: string, options?: {
         limit?: number;
         cursor?: string;

package/dist/convex-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convex-client.d.ts","sourceRoot":"","sources":["../src/convex-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,cAAc,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,aAAa,CAAuB;;IAM5C,OAAO,CAAC,UAAU;IAgClB,WAAW,IAAI,OAAO;IAItB,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAI3B,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA0B/C,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAyBlC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuCvD,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KACnB,GACL,OAAO,CAAC;QAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqCpD,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IA8BtD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAStD"}
+{"version":3,"file":"convex-client.d.ts","sourceRoot":"","sources":["../src/convex-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,WAAW,EAAE,CAAC;IAC9B,cAAc,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,QAAQ,CAAuB;;IAMvC,OAAO,CAAC,UAAU;IAkElB,WAAW,IAAI,OAAO;IAItB,gBAAgB,IAAI,MAAM,GAAG,IAAI;YAInB,WAAW;IA2BnB,cAAc,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA4B/C,UAAU,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IA2DlC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA+C7D,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,yBAAyB;IAgBjC,OAAO,CAAC,eAAe;IAoBjB,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;KACnB,GACL,OAAO,CAAC;QAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAepD,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAWtD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAOtD"}

package/dist/convex-client.js

@@ -2,15 +2,13 @@
  * Convex Client Wrapper
  *
  * Handles authentication and communication with Convex Cloud.
- * Reads credentials from ~/.convex/ or CONVEX_DEPLOY_KEY.
+ * Uses Convex system APIs to fetch schema information.
  */
-import { ConvexHttpClient } from 'convex/browser';
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
-import { homedir } from 'os';
 export class ConvexClient {
-    client = null;
     deploymentUrl = null;
+    adminKey = null;
     constructor() {
         this.initialize();
     }
@@ -18,53 +16,108 @@ export class ConvexClient {
         // Try environment variables first
         const deployKey = process.env.CONVEX_DEPLOY_KEY;
         const explicitUrl = process.env.CONVEX_URL;
+        if (deployKey) {
+            // Deploy key format: "prod:deploymentName|adminKey"
+            // Example: "prod:happy-animal-123|convex_admin_abc123xyz"
+            if (deployKey.includes('|')) {
+                const pipeIndex = deployKey.indexOf('|');
+                const prefix = deployKey.substring(0, pipeIndex);
+                this.adminKey = deployKey.substring(pipeIndex + 1);
+                // Extract deployment name from prefix (e.g., "prod:happy-animal-123")
+                if (prefix.includes(':')) {
+                    const colonIndex = prefix.indexOf(':');
+                    const deploymentName = prefix.substring(colonIndex + 1);
+                    if (!explicitUrl && deploymentName) {
+                        this.deploymentUrl = `https://${deploymentName}.convex.cloud`;
+                    }
+                }
+            }
+            else {
+                // Just an admin key without prefix
+                this.adminKey = deployKey;
+            }
+        }
         if (explicitUrl) {
             this.deploymentUrl = explicitUrl;
         }
-        else {
-            // Try to read from local Convex config
-            const convexConfigPath = join(homedir(), '.convex', 'config.json');
-            if (existsSync(convexConfigPath)) {
+        // Try to read from local project .env.local
+        if (!this.deploymentUrl) {
+            const envLocalPath = join(process.cwd(), '.env.local');
+            if (existsSync(envLocalPath)) {
                 try {
-                    const config = JSON.parse(readFileSync(convexConfigPath, 'utf-8'));
-                    if (config.deploymentUrl) {
-                        this.deploymentUrl = config.deploymentUrl;
+                    const envContent = readFileSync(envLocalPath, 'utf-8');
+                    const urlMatch = envContent.match(/CONVEX_URL=(.+)/);
+                    if (urlMatch) {
+                        this.deploymentUrl = urlMatch[1].trim().replace(/["']/g, '');
                     }
                 }
                 catch {
-                    // Ignore config read errors
+                    // Ignore errors
                 }
             }
         }
-        if (this.deploymentUrl) {
-            this.client = new ConvexHttpClient(this.deploymentUrl);
-            // Set auth token if deploy key is provided
-            if (deployKey) {
-                this.client.setAuth(deployKey);
+        // Try to read from project's .convex deployment state
+        if (!this.deploymentUrl || !this.adminKey) {
+            const convexJsonPath = join(process.cwd(), '.convex', 'deployment.json');
+            if (existsSync(convexJsonPath)) {
+                try {
+                    const config = JSON.parse(readFileSync(convexJsonPath, 'utf-8'));
+                    if (config.url && !this.deploymentUrl) {
+                        this.deploymentUrl = config.url;
+                    }
+                    if (config.adminKey && !this.adminKey) {
+                        this.adminKey = config.adminKey;
+                    }
+                }
+                catch {
+                    // Ignore errors
+                }
             }
         }
     }
     isConnected() {
-        return this.client !== null;
+        return this.deploymentUrl !== null;
     }
     getDeploymentUrl() {
         return this.deploymentUrl;
     }
+    async fetchConvex(path, body) {
+        if (!this.deploymentUrl) {
+            throw new Error('No deployment URL configured');
+        }
+        const url = `${this.deploymentUrl}${path}`;
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.adminKey) {
+            headers['Authorization'] = `Convex ${this.adminKey}`;
+        }
+        const response = await fetch(url, {
+            method: body ? 'POST' : 'GET',
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            throw new Error(`Convex API error: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
     async testConnection() {
-        if (!this.client || !this.deploymentUrl) {
+        if (!this.deploymentUrl) {
             return {
                 success: false,
                 error: 'No Convex deployment configured. Set CONVEX_URL or run "npx convex login".',
             };
         }
         try {
-            // Try to list tables to verify connection
-            const tables = await this.listTables();
+            // Try to get shapes (inferred schema) - this works without admin key for some deployments
+            const shapes = await this.fetchConvex('/api/shapes2');
+            const tables = Object.keys(shapes).filter(t => !t.startsWith('_'));
             return {
                 success: true,
                 deploymentUrl: this.deploymentUrl,
                 tableCount: tables.length,
-                tables: tables.map((t) => t.name),
+                tables,
             };
         }
         catch (error) {
@@ -76,130 +129,209 @@ export class ConvexClient {
         }
     }
     async listTables() {
-        if (!this.client) {
+        if (!this.deploymentUrl) {
             throw new Error('Convex client not initialized');
         }
         try {
-            // Call the schema_info:listTables function in the Convex deployment
-            const result = await this.client.query('schema_info:listTables');
-            if (Array.isArray(result)) {
-                return result.map((table) => ({
-                    name: table.name,
-                    documentCount: table.documentCount || 0,
-                    indexes: table.indexes || [],
-                }));
+            // Get inferred schemas from shapes API
+            const shapes = await this.fetchConvex('/api/shapes2');
+            const tables = [];
+            for (const [tableName, schema] of Object.entries(shapes)) {
+                // Skip system tables
+                if (tableName.startsWith('_'))
+                    continue;
+                tables.push({
+                    name: tableName,
+                    documentCount: 0, // Not available from shapes API
+                    indexes: [],
+                });
             }
-            return [];
+            // Try to get declared schema info if we have admin access
+            if (this.adminKey) {
+                try {
+                    const schemaResponse = await this.fetchConvex('/api/query', {
+                        path: '_system/frontend/getSchemas',
+                        args: {},
+                        format: 'json',
+                    });
+                    if (schemaResponse?.value?.active) {
+                        const activeSchema = JSON.parse(schemaResponse.value.active);
+                        if (activeSchema.tables) {
+                            for (const tableSchema of activeSchema.tables) {
+                                const existing = tables.find(t => t.name === tableSchema.tableName);
+                                if (existing) {
+                                    existing.indexes = tableSchema.indexes?.map((i) => i.indexDescriptor) || [];
+                                }
+                                else if (!tableSchema.tableName.startsWith('_')) {
+                                    tables.push({
+                                        name: tableSchema.tableName,
+                                        documentCount: 0,
+                                        indexes: tableSchema.indexes?.map((i) => i.indexDescriptor) || [],
+                                    });
+                                }
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // Admin query failed, continue with shapes data only
+                }
+            }
+            return tables.sort((a, b) => a.name.localeCompare(b.name));
         }
         catch (error) {
-            // If the query function doesn't exist, return empty array
             console.error('Failed to list tables:', error);
             return [];
         }
     }
     async getTableSchema(tableName) {
-        if (!this.client) {
+        if (!this.deploymentUrl) {
             throw new Error('Convex client not initialized');
         }
+        const result = {
+            tableName,
+            declaredFields: [],
+            inferredFields: [],
+        };
         try {
-            // Call the schema_info:listTables function and find the specific table
-            const result = await this.client.query('schema_info:listTables');
-            if (Array.isArray(result)) {
-                const table = result.find((t) => t.name === tableName);
-                if (table && table.fields) {
-                    return {
-                        tableName,
-                        declaredFields: table.fields.map((f) => ({
-                            name: f.name,
-                            type: f.type,
-                            optional: f.optional || false,
-                        })),
-                        inferredFields: [],
-                    };
+            // Get inferred schema from shapes API
+            const shapes = await this.fetchConvex('/api/shapes2');
+            const tableShape = shapes[tableName];
+            if (tableShape) {
+                result.inferredFields = this.parseShapeToFields(tableShape);
+            }
+            // Try to get declared schema if we have admin access
+            if (this.adminKey) {
+                try {
+                    const schemaResponse = await this.fetchConvex('/api/query', {
+                        path: '_system/frontend/getSchemas',
+                        args: {},
+                        format: 'json',
+                    });
+                    if (schemaResponse?.value?.active) {
+                        const activeSchema = JSON.parse(schemaResponse.value.active);
+                        const tableSchema = activeSchema.tables?.find((t) => t.tableName === tableName);
+                        if (tableSchema?.documentType) {
+                            result.declaredFields = this.parseDocumentTypeToFields(tableSchema.documentType);
+                        }
+                    }
+                }
+                catch {
+                    // Admin query failed, continue with inferred schema only
                 }
             }
-            return {
-                tableName,
-                declaredFields: [],
-                inferredFields: [],
-            };
         }
         catch (error) {
             console.error('Failed to get table schema:', error);
-            return {
-                tableName,
-                declaredFields: [],
-                inferredFields: [],
-            };
         }
+        return result;
     }
-    async queryDocuments(tableName, options = {}) {
-        if (!this.client) {
-            throw new Error('Convex client not initialized');
-        }
-        try {
-            // Call the schema_info:getDocuments function to get sample data
-            const result = await this.client.query('schema_info:getDocuments');
-            if (result && typeof result === 'object') {
-                const tableData = result[tableName];
-                if (Array.isArray(tableData)) {
-                    const documents = tableData.map((doc) => ({
-                        _id: doc._id,
-                        _creationTime: doc._creationTime,
-                        ...doc,
-                    }));
-                    return {
-                        documents: documents.slice(0, options.limit || 50),
-                        nextCursor: undefined,
-                    };
+    parseShapeToFields(shape) {
+        const fields = [];
+        if (shape && typeof shape === 'object') {
+            // Handle different shape formats
+            if (shape.type === 'Object' && shape.fields) {
+                for (const [name, fieldShape] of Object.entries(shape.fields)) {
+                    fields.push({
+                        name,
+                        type: this.shapeToTypeString(fieldShape),
+                        optional: fieldShape.optional || false,
+                    });
+                }
+            }
+            else if (Array.isArray(shape)) {
+                // Union of shapes
+                for (const s of shape) {
+                    if (s.type === 'Object' && s.fields) {
+                        for (const [name, fieldShape] of Object.entries(s.fields)) {
+                            if (!fields.find(f => f.name === name)) {
+                                fields.push({
+                                    name,
+                                    type: this.shapeToTypeString(fieldShape),
+                                    optional: true, // Might not exist in all variants
+                                });
+                            }
+                        }
+                    }
                 }
             }
-            return {
-                documents: [],
-                nextCursor: undefined,
-            };
-        }
-        catch (error) {
-            console.error('Failed to query documents:', error);
-            return {
-                documents: [],
-                nextCursor: undefined,
-            };
         }
+        return fields;
     }
-    async getAllDocuments() {
-        if (!this.client) {
-            throw new Error('Convex client not initialized');
+    shapeToTypeString(shape) {
+        if (!shape)
+            return 'unknown';
+        if (typeof shape === 'string')
+            return shape;
+        if (shape.type) {
+            switch (shape.type) {
+                case 'String': return 'string';
+                case 'Number': return 'number';
+                case 'Boolean': return 'boolean';
+                case 'Id': return `Id<"${shape.tableName || 'unknown'}">`;
+                case 'Array': return `Array<${this.shapeToTypeString(shape.value)}>`;
+                case 'Object': return 'object';
+                case 'Union': return shape.values?.map((v) => this.shapeToTypeString(v)).join(' | ') || 'union';
+                case 'Null': return 'null';
+                default: return shape.type.toLowerCase();
+            }
         }
-        try {
-            // Call the schema_info:getDocuments function to get all documents
-            const result = await this.client.query('schema_info:getDocuments');
-            if (result && typeof result === 'object') {
-                const allDocs = {};
-                for (const [tableName, docs] of Object.entries(result)) {
-                    if (Array.isArray(docs)) {
-                        allDocs[tableName] = docs.map((doc) => ({
-                            _id: doc._id,
-                            _creationTime: doc._creationTime,
-                            ...doc,
-                        }));
-                    }
-                }
-                return allDocs;
+        return 'unknown';
+    }
+    parseDocumentTypeToFields(docType) {
+        const fields = [];
+        if (docType && docType.type === 'object' && docType.value) {
+            for (const [name, fieldType] of Object.entries(docType.value)) {
+                fields.push({
+                    name,
+                    type: this.docTypeToString(fieldType),
+                    optional: fieldType?.fieldType?.type === 'optional',
+                });
             }
-            return {};
         }
-        catch (error) {
-            console.error('Failed to get all documents:', error);
-            return {};
+        return fields;
+    }
+    docTypeToString(fieldType) {
+        if (!fieldType)
+            return 'unknown';
+        const ft = fieldType.fieldType || fieldType;
+        if (ft.type === 'optional' && ft.inner) {
+            return this.docTypeToString(ft.inner) + '?';
+        }
+        switch (ft.type) {
+            case 'string': return 'string';
+            case 'number': return 'number';
+            case 'boolean': return 'boolean';
+            case 'id': return `Id<"${ft.tableName || 'unknown'}">`;
+            case 'array': return `Array<${this.docTypeToString(ft.value)}>`;
+            case 'object': return 'object';
+            default: return ft.type || 'unknown';
+        }
+    }
+    async queryDocuments(tableName, options = {}) {
+        if (!this.deploymentUrl) {
+            throw new Error('Convex client not initialized');
+        }
+        // Note: Querying documents requires running a query function
+        // This is a simplified implementation that returns empty for now
+        // A full implementation would need a deployed query function
+        return {
+            documents: [],
+            nextCursor: undefined,
+        };
+    }
+    async getAllDocuments() {
+        if (!this.deploymentUrl) {
+            throw new Error('Convex client not initialized');
         }
+        // Note: Getting all documents requires running query functions
+        // This returns empty for now
+        return {};
     }
     async runQuery(queryString) {
-        if (!this.client) {
+        if (!this.deploymentUrl) {
             throw new Error('Convex client not initialized');
         }
-        // Execute a custom query
-        // Real implementation would use Convex's query API
         throw new Error('Custom queries not yet implemented');
     }
 }

package/dist/convex-client.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "convex-mcp-visual",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Visual MCP tools for exploring Convex databases - graph view, schema browser, and dashboards",
   "type": "module",
   "main": "dist/index.js",
@@ -8,7 +8,8 @@
     "convex-mcp-visual": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "npm run build:server && npm run build:apps",