truss-db-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TRUSS
+
+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.

package/README.md

@@ -0,0 +1,69 @@
+# truss-db-mcp
+
+Database query MCP server for Claude Code. Connect to SQLite, PostgreSQL, or MySQL databases directly from your AI assistant.
+
+## Quick Start
+
+```json
+{
+  "mcpServers": {
+    "truss-db": {
+      "command": "npx",
+      "args": ["-y", "truss-db-mcp"]
+    }
+  }
+}
+```
+
+## Free Tier Tools
+
+| Tool | Description |
+|------|-------------|
+| `connect` | Connect to a SQLite database file |
+| `list_tables` | List all tables with row counts and column info |
+| `describe_table` | Detailed schema: columns, types, indexes, foreign keys |
+| `query` | Execute read-only SQL queries (SELECT) |
+
+## Pro Tier Tools ($25/mo)
+
+| Tool | Description |
+|------|-------------|
+| `natural_language_query` | Ask questions in plain English, get SQL + results |
+| `optimize_query` | EXPLAIN analysis with index suggestions |
+| `generate_migration` | Generate up/down SQL migrations from descriptions |
+| `export_data` | Export query results as CSV or JSON |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `TRUSS_LICENSE_KEY` | No | Pro license key |
+| `ANTHROPIC_API_KEY` | Pro | For AI-powered features (natural language query, migration generation) |
+| `OPENAI_API_KEY` | Pro | Alternative AI provider |
+| `DATABASE_URL` | No | Connection URL for PostgreSQL/MySQL (Pro) |
+
+## Usage Examples
+
+### Connect to a database
+```
+Use the connect tool with path: "./my-app.db"
+```
+
+### Query data
+```
+Use the query tool with sql: "SELECT * FROM users LIMIT 10"
+```
+
+### Natural language query (Pro)
+```
+Use natural_language_query with question: "What are the top 5 customers by total spend?"
+```
+
+### Optimize a slow query (Pro)
+```
+Use optimize_query with sql: "SELECT * FROM orders WHERE status = 'pending'"
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+// Tool registrations
+import { registerConnect } from './tools/connect.js';
+import { registerListTables } from './tools/list-tables.js';
+import { registerDescribeTable } from './tools/describe-table.js';
+import { registerQuery } from './tools/query.js';
+import { registerNaturalLanguageQuery } from './tools/natural-language-query.js';
+import { registerOptimizeQuery } from './tools/optimize-query.js';
+import { registerGenerateMigration } from './tools/generate-migration.js';
+import { registerExportData } from './tools/export-data.js';
+// Lib
+import { closeConnection } from './lib/connection.js';
+import { getLicenseStatus } from './lib/license.js';
+const server = new McpServer({
+    name: 'truss-db-mcp',
+    version: '1.0.0',
+});
+// ── Status Tool ─────────────────────────────────────────────────────
+server.tool('db_status', 'Check database connection status and license tier.', {}, async () => {
+    const license = await getLicenseStatus();
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    license: {
+                        tier: license.tier,
+                        valid: license.valid,
+                        expires_at: license.expiresAt,
+                    },
+                    ...(license.tier === 'free' ? {
+                        upgrade_info: {
+                            url: 'https://truss.dev/pricing',
+                            price: '$25/mo',
+                            pro_features: [
+                                'Natural language to SQL (AI-powered)',
+                                'Query optimization & EXPLAIN analysis',
+                                'Migration generation',
+                                'CSV/JSON data export',
+                                'Write operations (INSERT/UPDATE/DELETE)',
+                                'PostgreSQL & MySQL support',
+                            ],
+                        },
+                    } : {}),
+                }, null, 2),
+            }],
+    };
+});
+// ── Free Tier Tools ─────────────────────────────────────────────────
+registerConnect(server);
+registerListTables(server);
+registerDescribeTable(server);
+registerQuery(server);
+// ── Pro Tier Tools ──────────────────────────────────────────────────
+registerNaturalLanguageQuery(server);
+registerOptimizeQuery(server);
+registerGenerateMigration(server);
+registerExportData(server);
+// ── Start Server ────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    // Clean shutdown
+    process.on('SIGINT', () => {
+        closeConnection();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        closeConnection();
+        process.exit(0);
+    });
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('Fatal error starting MCP server:', err);
+    closeConnection();
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/ai-query.d.ts

@@ -0,0 +1,7 @@
+import type { NaturalLanguageQueryResult } from '../types.js';
+export declare function naturalLanguageToSql(question: string, filterTables?: string[]): Promise<NaturalLanguageQueryResult>;
+export declare function generateMigrationSql(description: string, dialect?: string): Promise<{
+    upSql: string;
+    downSql: string;
+}>;
+//# sourceMappingURL=ai-query.d.ts.map

package/dist/lib/ai-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-query.d.ts","sourceRoot":"","sources":["../../src/lib/ai-query.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAa,MAAM,aAAa,CAAC;AA0HzE,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,OAAO,CAAC,0BAA0B,CAAC,CA6CrC;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,MAAiB,GACzB,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgG7C"}

package/dist/lib/ai-query.js

@@ -0,0 +1,224 @@
+import { getConfig } from './config.js';
+import { listTables, executeQuery } from './connection.js';
+// ── Schema Summary ──────────────────────────────────────────────────
+function buildSchemaContext(filterTables) {
+    const tables = listTables();
+    const relevant = filterTables
+        ? tables.filter(t => filterTables.includes(t.name))
+        : tables;
+    return relevant.map(t => formatTableSchema(t)).join('\n\n');
+}
+function formatTableSchema(t) {
+    const cols = t.columns.map(c => {
+        const parts = [`  ${c.name} ${c.type}`];
+        if (c.primaryKey)
+            parts.push('PRIMARY KEY');
+        if (!c.nullable)
+            parts.push('NOT NULL');
+        if (c.defaultValue !== null)
+            parts.push(`DEFAULT ${c.defaultValue}`);
+        return parts.join(' ');
+    }).join(',\n');
+    return `TABLE ${t.name} (${t.rowCount} rows):\n${cols}`;
+}
+async function callAnthropic(prompt, apiKey) {
+    const response = await fetch('https://api.anthropic.com/v1/messages', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'x-api-key': apiKey,
+            'anthropic-version': '2023-06-01',
+        },
+        body: JSON.stringify({
+            model: 'claude-sonnet-4-20250514',
+            max_tokens: 1024,
+            messages: [{
+                    role: 'user',
+                    content: prompt,
+                }],
+        }),
+        signal: AbortSignal.timeout(30000),
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`Anthropic API error (${response.status}): ${body}`);
+    }
+    const data = await response.json();
+    const text = data.content.find(c => c.type === 'text')?.text ?? '';
+    return parseAiResponse(text);
+}
+async function callOpenAI(prompt, apiKey) {
+    const response = await fetch('https://api.openai.com/v1/chat/completions', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'Authorization': `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            model: 'gpt-4o-mini',
+            messages: [{
+                    role: 'user',
+                    content: prompt,
+                }],
+            max_tokens: 1024,
+        }),
+        signal: AbortSignal.timeout(30000),
+    });
+    if (!response.ok) {
+        const body = await response.text();
+        throw new Error(`OpenAI API error (${response.status}): ${body}`);
+    }
+    const data = await response.json();
+    const text = data.choices[0]?.message?.content ?? '';
+    return parseAiResponse(text);
+}
+function parseAiResponse(text) {
+    // Extract SQL from code blocks or raw text
+    const sqlMatch = text.match(/```sql\n([\s\S]*?)```/);
+    const sql = sqlMatch ? sqlMatch[1].trim() : extractSqlFromText(text);
+    // Extract explanation (everything that is not the SQL block)
+    const explanation = text
+        .replace(/```sql[\s\S]*?```/, '')
+        .replace(/^SQL:\s*/mi, '')
+        .trim()
+        || 'Query generated from natural language.';
+    if (!sql) {
+        throw new Error('AI did not produce a valid SQL query. Try rephrasing your question.');
+    }
+    return { sql, explanation };
+}
+function extractSqlFromText(text) {
+    // Try to find a SELECT/WITH statement in the text
+    const match = text.match(/((?:WITH|SELECT)\b[\s\S]*?;)/i);
+    return match ? match[1].trim() : '';
+}
+// ── Public API ──────────────────────────────────────────────────────
+export async function naturalLanguageToSql(question, filterTables) {
+    const config = getConfig();
+    if (!config.anthropicApiKey && !config.openaiApiKey) {
+        throw new Error('Natural language queries require an AI API key. ' +
+            'Set ANTHROPIC_API_KEY or OPENAI_API_KEY in your environment.');
+    }
+    const schema = buildSchemaContext(filterTables);
+    const prompt = `You are a SQL query generator. Given the database schema below and a natural language question, generate the correct SQL query.
+
+DATABASE SCHEMA:
+${schema}
+
+QUESTION: ${question}
+
+Respond with:
+1. The SQL query in a \`\`\`sql code block
+2. A brief explanation of what the query does
+
+Important:
+- Use only tables and columns that exist in the schema above
+- Write SQLite-compatible SQL
+- Use appropriate JOINs when data spans multiple tables
+- Always include a LIMIT if the result could be large (default LIMIT 100)`;
+    let aiResult;
+    if (config.anthropicApiKey) {
+        aiResult = await callAnthropic(prompt, config.anthropicApiKey);
+    }
+    else {
+        aiResult = await callOpenAI(prompt, config.openaiApiKey);
+    }
+    // Execute the generated SQL
+    const results = executeQuery(aiResult.sql);
+    return {
+        sql: aiResult.sql,
+        explanation: aiResult.explanation,
+        results,
+    };
+}
+export async function generateMigrationSql(description, dialect = 'sqlite') {
+    const config = getConfig();
+    if (!config.anthropicApiKey && !config.openaiApiKey) {
+        throw new Error('Migration generation requires an AI API key. ' +
+            'Set ANTHROPIC_API_KEY or OPENAI_API_KEY in your environment.');
+    }
+    let schemaContext = '';
+    try {
+        schemaContext = buildSchemaContext();
+    }
+    catch {
+        // No connection -- generate migration without existing schema context
+    }
+    const prompt = `You are a database migration generator. Generate SQL migration statements for the following change.
+
+${schemaContext ? `EXISTING SCHEMA:\n${schemaContext}\n\n` : ''}DIALECT: ${dialect}
+CHANGE DESCRIPTION: ${description}
+
+Respond with two SQL code blocks:
+
+1. UP migration (apply the change):
+\`\`\`sql
+-- up migration here
+\`\`\`
+
+2. DOWN migration (revert the change):
+\`\`\`sql
+-- down migration here
+\`\`\`
+
+Important:
+- Use IF EXISTS / IF NOT EXISTS where appropriate
+- Make migrations idempotent when possible
+- Use correct syntax for the ${dialect} dialect`;
+    let text;
+    if (config.anthropicApiKey) {
+        const response = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': config.anthropicApiKey,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model: 'claude-sonnet-4-20250514',
+                max_tokens: 2048,
+                messages: [{ role: 'user', content: prompt }],
+            }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (!response.ok)
+            throw new Error(`Anthropic API error: ${response.status}`);
+        const data = await response.json();
+        text = data.content.find(c => c.type === 'text')?.text ?? '';
+    }
+    else {
+        const response = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${config.openaiApiKey}`,
+            },
+            body: JSON.stringify({
+                model: 'gpt-4o-mini',
+                messages: [{ role: 'user', content: prompt }],
+                max_tokens: 2048,
+            }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (!response.ok)
+            throw new Error(`OpenAI API error: ${response.status}`);
+        const data = await response.json();
+        text = data.choices[0]?.message?.content ?? '';
+    }
+    // Parse two SQL blocks from response
+    const sqlBlocks = [...text.matchAll(/```sql\n([\s\S]*?)```/g)].map(m => m[1].trim());
+    if (sqlBlocks.length < 2) {
+        // Try to split on common markers
+        const upMatch = text.match(/(?:UP|up|Up)[:\s]*\n*```sql\n([\s\S]*?)```/);
+        const downMatch = text.match(/(?:DOWN|down|Down)[:\s]*\n*```sql\n([\s\S]*?)```/);
+        return {
+            upSql: upMatch?.[1]?.trim() || sqlBlocks[0] || '-- Could not generate up migration',
+            downSql: downMatch?.[1]?.trim() || sqlBlocks[1] || '-- Could not generate down migration',
+        };
+    }
+    return {
+        upSql: sqlBlocks[0],
+        downSql: sqlBlocks[1],
+    };
+}
+//# sourceMappingURL=ai-query.js.map

package/dist/lib/ai-query.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,4 @@
+import type { TrussConfig } from '../types.js';
+export declare function getConfig(): TrussConfig;
+export declare function getDataDir(): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAW/C,wBAAgB,SAAS,IAAI,WAAW,CAcvC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/lib/config.js

@@ -0,0 +1,30 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mkdirSync } from 'node:fs';
+const DATA_DIR = join(homedir(), '.truss');
+// Ensure data directory exists on import
+try {
+    mkdirSync(DATA_DIR, { recursive: true });
+}
+catch {
+    // ignore -- directory already exists
+}
+export function getConfig() {
+    return {
+        licenseKey: process.env.TRUSS_LICENSE_KEY,
+        databaseUrl: process.env.DATABASE_URL,
+        dbHost: process.env.DB_HOST,
+        dbPort: process.env.DB_PORT ? parseInt(process.env.DB_PORT, 10) : undefined,
+        dbName: process.env.DB_NAME,
+        dbUser: process.env.DB_USER,
+        dbPassword: process.env.DB_PASSWORD,
+        anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+        openaiApiKey: process.env.OPENAI_API_KEY,
+        trussApiBaseUrl: process.env.TRUSS_API_BASE_URL || 'https://api.truss.dev',
+        dataDir: DATA_DIR,
+    };
+}
+export function getDataDir() {
+    return DATA_DIR;
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AAE3C,yCAAyC;AACzC,IAAI,CAAC;IACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAAC,MAAM,CAAC;IACP,qCAAqC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACzC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QACrC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;QAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QAC3E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;QAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;QAC3B,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;QACnC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QAC9C,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;QACxC,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,uBAAuB;QAC1E,OAAO,EAAE,QAAQ;KAClB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/connection.d.ts

@@ -0,0 +1,14 @@
+import Database from 'better-sqlite3';
+import type { DatabaseDialect, ConnectionInfo, TableInfo, TableSchema, QueryResult } from '../types.js';
+export declare function connectSqlite(dbPath: string): ConnectionInfo;
+export declare function getDb(): Database.Database;
+export declare function getDialect(): DatabaseDialect;
+export declare function isConnected(): boolean;
+export declare function closeConnection(): void;
+export declare function listTables(): TableInfo[];
+export declare function describeTable(tableName: string): TableSchema;
+export declare function isWriteQuery(sql: string): boolean;
+export declare function executeQuery(sql: string, params?: unknown[]): QueryResult;
+export declare function executeReadOnlyQuery(sql: string, params?: unknown[]): QueryResult;
+export declare function explainQuery(sql: string): string;
+//# sourceMappingURL=connection.d.ts.map

package/dist/lib/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/lib/connection.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,SAAS,EACT,WAAW,EAIX,WAAW,EACZ,MAAM,aAAa,CAAC;AAUrB,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CA8B5D;AAID,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAKzC;AAED,wBAAgB,UAAU,IAAI,eAAe,CAE5C;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAMtC;AAYD,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAiBxC;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CA8B5D;AAuED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,WAAW,CAyB7E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,OAAO,EAAO,GAAG,WAAW,CAQrF;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUhD"}