sqlite-slim 0.0.2-slim.1.9

package/README.md

@@ -0,0 +1,181 @@
+# sqlite-slim
+
+> **Sqlite MCP server optimized for AI assistants** — Reduce context window tokens by 32.4% while keeping full functionality. Compatible with Claude, ChatGPT, Gemini, Cursor, and all MCP clients.
+
+[![npm version](https://img.shields.io/npm/v/sqlite-slim.svg)](https://www.npmjs.com/package/sqlite-slim)
+[![Test Status](https://img.shields.io/badge/tests-passing-brightgreen)](https://github.com/mcpslim/mcpslim)
+[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
+
+## What is sqlite-slim?
+
+A **token-optimized** version of the Sqlite [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server.
+
+### The Problem
+
+MCP tool schemas consume significant **context window tokens**. When AI assistants like Claude or ChatGPT load MCP tools, each tool definition takes up valuable context space.
+
+The original `mcp-server-sqlite` loads **6 tools** consuming approximately **~3,685 tokens** — that's space you could use for actual conversation.
+
+### The Solution
+
+`sqlite-slim` intelligently **groups 6 tools into 4 semantic operations**, reducing token usage by **32.4%** — with **zero functionality loss**.
+
+Your AI assistant sees fewer, smarter tools. Every original capability remains available.
+
+## Performance
+
+| Metric | Original | Slim | Reduction |
+|--------|----------|------|-----------|
+| Tools | 6 | 4 | **-33%** |
+| Schema Tokens | 265 | 211 | **20.4%** |
+| Claude Code (est.) | ~3,685 | ~2,491 | **~32.4%** |
+
+> **Benchmark Info**
+> - Original: `mcp-server-sqlite@0.0.2`
+> - Schema tokens measured with [tiktoken](https://github.com/openai/tiktoken) (cl100k_base)
+> - Claude Code estimate includes ~570 tokens/tool overhead
+
+## Quick Start
+
+### One-Command Setup (Recommended)
+
+```bash
+# Claude Desktop - auto-configure
+npx sqlite-slim --setup claude
+
+# Cursor - auto-configure
+npx sqlite-slim --setup cursor
+
+# Interactive mode (choose your client)
+npx sqlite-slim --setup
+```
+
+Done! Restart your app to use sqlite.
+
+### CLI Tools (already have CLI?)
+
+```bash
+# Claude Code (creates .mcp.json in project root)
+claude mcp add sqlite -s project -- npx -y sqlite-slim@latest
+
+# Windows: use cmd /c wrapper
+claude mcp add sqlite -s project -- cmd /c npx -y sqlite-slim@latest
+
+# VS Code (Copilot, Cline, Roo Code)
+code --add-mcp '{"name":"sqlite","command":"npx","args":["-y","sqlite-slim@latest"]}'
+```
+
+## Manual Setup
+
+<details>
+<summary>Click to expand manual configuration options</summary>
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+| OS | Path |
+|----|------|
+| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
+| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
+
+```json
+{
+  "mcpServers": {
+    "sqlite": {
+      "command": "npx",
+      "args": ["-y", "sqlite-slim@latest"]
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to `.cursor/mcp.json` (global) or `<project>/.cursor/mcp.json` (project):
+
+```json
+{
+  "mcpServers": {
+    "sqlite": {
+      "command": "npx",
+      "args": ["-y", "sqlite-slim@latest"]
+    }
+  }
+}
+```
+
+</details>
+
+## How It Works
+
+MCPSlim acts as a **transparent bridge** between AI models and the original MCP server:
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│  Without MCPSlim                                                │
+│                                                                 │
+│  [AI Model] ──── reads 6 tool schemas ────→ [Original MCP]    │
+│             (~3,685 tokens loaded into context)                 │
+├─────────────────────────────────────────────────────────────────┤
+│  With MCPSlim                                                   │
+│                                                                 │
+│  [AI Model] ───→ [MCPSlim Bridge] ───→ [Original MCP]           │
+│       │                │                      │                 │
+│   Sees 4 grouped      Translates to        Executes actual   │
+│   tools only         original call       tool & returns    │
+│   (~2,491 tokens)                                              │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+### How Translation Works
+
+1. **AI reads slim schema** — Only 4 grouped tools instead of 6
+2. **AI calls grouped tool** — e.g., `interaction({ action: "click", ... })`
+3. **MCPSlim translates** — Converts to original: `browser_click({ ... })`
+4. **Original MCP executes** — Real server processes the request
+5. **Response returned** — Result passes back unchanged
+
+**Zero functionality loss. 32.4% token savings.**
+
+## Available Tool Groups
+
+| Group | Actions |
+|-------|---------|
+| `query` | 2 |
+| `table` | 2 |
+
+Plus **2 passthrough tools** — tools that don't group well are kept as-is with optimized descriptions.
+
+## Compatibility
+
+- ✅ **Full functionality** — All original `mcp-server-sqlite` features preserved
+- ✅ **All AI assistants** — Works with Claude, ChatGPT, Gemini, Copilot, and any MCP client
+- ✅ **Drop-in replacement** — Same capabilities, just use grouped action names
+- ✅ **Tested** — Schema compatibility verified via automated tests
+
+## FAQ
+
+### Does this reduce functionality?
+
+**No.** Every original tool is accessible. Tools are grouped semantically (e.g., `click`, `hover`, `drag` → `interaction`), but all actions remain available via the `action` parameter.
+
+### Why do AI assistants need token optimization?
+
+AI models have limited context windows. MCP tool schemas consume tokens that could be used for conversation, code, or documents. Reducing tool schema size means more room for actual work.
+
+### Is this officially supported?
+
+MCPSlim is a community project. It wraps official MCP servers transparently — the original server does all the real work.
+
+## License
+
+MIT
+
+---
+
+<p align="center">
+  Powered by <a href="https://github.com/mcpslim/mcpslim"><b>MCPSlim</b></a> — MCP Token Optimizer
+  <br>
+  <sub>Reduce AI context usage. Keep full functionality.</sub>
+</p>

package/index.js

@@ -0,0 +1,271 @@
+#!/usr/bin/env node
+/**
+ * sqlite-slim - Slimmed sqlite MCP for Claude
+ * Reduces token usage by grouping similar tools
+ *
+ * Usage:
+ *   npx sqlite-slim                    # Run MCP server
+ *   npx sqlite-slim --setup            # Auto-configure (interactive)
+ *   npx sqlite-slim --setup claude     # Auto-configure for Claude Desktop
+ *   npx sqlite-slim --setup cursor     # Auto-configure for Cursor
+ *   npx sqlite-slim --setup claude-code # Auto-configure for Claude Code CLI
+ */
+
+const { spawn, execSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+const readline = require('readline');
+
+const MCP_NAME = 'sqlite-slim';
+const PACKAGE_NAME = 'sqlite-slim';
+
+// 환경변수 요구사항 (빌드 시 주입)
+const REQUIRED_ENV_VARS = [];
+
+// ============================================
+// Setup Mode: Auto-configure MCP clients
+// ============================================
+
+const CONFIG_PATHS = {
+  'claude': getClaudeDesktopConfigPath(),
+  'claude-desktop': getClaudeDesktopConfigPath(),
+  'cursor': getCursorConfigPath(),
+};
+
+function getClaudeDesktopConfigPath() {
+  if (os.platform() === 'win32') {
+    return path.join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json');
+  } else if (os.platform() === 'darwin') {
+    return path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  } else {
+    return path.join(os.homedir(), '.config', 'claude', 'claude_desktop_config.json');
+  }
+}
+
+function getCursorConfigPath() {
+  // Global config
+  if (os.platform() === 'win32') {
+    return path.join(process.env.APPDATA || '', 'Cursor', 'User', 'globalStorage', 'mcp.json');
+  } else {
+    return path.join(os.homedir(), '.cursor', 'mcp.json');
+  }
+}
+
+function addToConfig(configPath, mcpName, mcpConfig) {
+  let config = { mcpServers: {} };
+
+  // 디렉토리 생성
+  const dir = path.dirname(configPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  // 기존 설정 로드
+  if (fs.existsSync(configPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+      if (!config.mcpServers) config.mcpServers = {};
+    } catch (e) {
+      console.error('⚠️  Failed to parse existing config, creating new one');
+    }
+  }
+
+  // 이미 존재하는지 확인
+  if (config.mcpServers[mcpName]) {
+    console.log(`ℹ️  ${mcpName} already configured in ${configPath}`);
+    return false;
+  }
+
+  // 새 MCP 추가
+  config.mcpServers[mcpName] = mcpConfig;
+  fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+  console.log(`✅ Added ${mcpName} to ${configPath}`);
+  return true;
+}
+
+async function interactiveSetup() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  const question = (q) => new Promise(resolve => rl.question(q, resolve));
+
+  console.log('\n🔧 ' + PACKAGE_NAME + ' Setup\n');
+  console.log('Select your MCP client:\n');
+  console.log('  1. Claude Desktop');
+  console.log('  2. Cursor');
+  console.log('  3. Claude Code (CLI)');
+  console.log('  4. VS Code (Copilot)');
+  console.log('  5. Cancel\n');
+
+  const choice = await question('Enter choice (1-5): ');
+  rl.close();
+
+  // 환경변수 플래그 생성
+  const envFlags = REQUIRED_ENV_VARS.map(v => `--env ${v}=<YOUR_${v.split('_').pop()}>`).join(' ');
+  const envJson = REQUIRED_ENV_VARS.length > 0
+    ? `,"env":{${REQUIRED_ENV_VARS.map(v => `"${v}":"<YOUR_${v.split('_').pop()}>"`).join(',')}}`
+    : '';
+
+  switch (choice.trim()) {
+    case '1':
+      return setupClient('claude');
+    case '2':
+      return setupClient('cursor');
+    case '3':
+      console.log('\nRun this command:\n');
+      if (REQUIRED_ENV_VARS.length > 0) {
+        console.log(`  claude mcp add ${MCP_NAME} -s project ${envFlags} -- npx -y ${PACKAGE_NAME}@latest\n`);
+      } else {
+        console.log(`  claude mcp add ${MCP_NAME} -s project -- npx -y ${PACKAGE_NAME}@latest\n`);
+      }
+      console.log('  (Windows: use "cmd /c npx" instead of "npx")\n');
+      return true;
+    case '4':
+      console.log('\nRun this command:\n');
+      console.log(`  code --add-mcp '{"name":"${MCP_NAME}","command":"npx","args":["-y","${PACKAGE_NAME}@latest"]${envJson}}'\n`);
+      return true;
+    case '5':
+    default:
+      console.log('Cancelled.');
+      return false;
+  }
+}
+
+function setupClaudeCode() {
+  // 환경변수 플래그 생성
+  const envFlags = REQUIRED_ENV_VARS.map(v => `--env ${v}=<YOUR_${v.split('_').pop()}>`).join(' ');
+
+  // Windows에서는 cmd /c wrapper 필요
+  const npxCmd = os.platform() === 'win32' ? 'cmd /c npx' : 'npx';
+
+  let cmd = `claude mcp add ${MCP_NAME} -s project`;
+  if (REQUIRED_ENV_VARS.length > 0) {
+    cmd += ` ${envFlags}`;
+  }
+  cmd += ` -- ${npxCmd} -y ${PACKAGE_NAME}@latest`;
+
+  console.log(`\n🔧 Adding ${MCP_NAME} to Claude Code...\n`);
+  console.log(`Running: ${cmd}\n`);
+
+  try {
+    execSync(cmd, { stdio: 'inherit', shell: true });
+    console.log(`\n🎉 Setup complete! ${MCP_NAME} is now available in Claude Code.\n`);
+    if (REQUIRED_ENV_VARS.length > 0) {
+      console.log(`⚠️  Don't forget to set environment variables:`);
+      for (const envVar of REQUIRED_ENV_VARS) {
+        console.log(`   - ${envVar}`);
+      }
+      console.log('');
+    }
+    return true;
+  } catch (err) {
+    console.error(`\n❌ Failed to add MCP. Is Claude Code CLI installed?\n`);
+    console.log(`Try running manually:\n  ${cmd}\n`);
+    return false;
+  }
+}
+
+function setupClient(client) {
+  // Claude Code CLI는 별도 처리
+  if (client === 'claude-code') {
+    return setupClaudeCode();
+  }
+
+  const configPath = CONFIG_PATHS[client];
+  if (!configPath) {
+    console.error(`❌ Unknown client: ${client}`);
+    console.log('Supported: claude, claude-desktop, cursor, claude-code');
+    return false;
+  }
+
+  const mcpConfig = {
+    command: 'npx',
+    args: ['-y', PACKAGE_NAME + '@latest']
+  };
+
+  // 환경변수가 필요한 경우 env 블록 추가 (플레이스홀더)
+  if (REQUIRED_ENV_VARS.length > 0) {
+    mcpConfig.env = {};
+    for (const envVar of REQUIRED_ENV_VARS) {
+      mcpConfig.env[envVar] = `<YOUR_${envVar.split('_').pop()}>`;
+    }
+  }
+
+  const success = addToConfig(configPath, MCP_NAME, mcpConfig);
+
+  if (success) {
+    if (REQUIRED_ENV_VARS.length > 0) {
+      console.log(`\n⚠️  This MCP requires environment variables!`);
+      console.log(`   Edit ${configPath} and update:`);
+      for (const envVar of REQUIRED_ENV_VARS) {
+        console.log(`     - ${envVar}`);
+      }
+      console.log(`\n🎉 Setup complete! Update env vars, then restart ${client}.\n`);
+    } else {
+      console.log(`\n🎉 Setup complete! Restart ${client} to use ${MCP_NAME}.\n`);
+    }
+  }
+
+  return success;
+}
+
+// ============================================
+// Main: Check for --setup flag
+// ============================================
+
+const args = process.argv.slice(2);
+const setupIndex = args.indexOf('--setup');
+
+if (setupIndex !== -1) {
+  const client = args[setupIndex + 1];
+
+  if (client && !client.startsWith('-')) {
+    // Specific client: npx xxx-slim --setup claude
+    setupClient(client);
+  } else {
+    // Interactive: npx xxx-slim --setup
+    interactiveSetup().then(() => process.exit(0));
+  }
+} else {
+  // ============================================
+  // Normal Mode: Run MCP server
+  // ============================================
+
+  // 플랫폼별 바이너리 이름 결정
+  function getBinaryName() {
+    const platform = os.platform();
+    const arch = os.arch();
+    if (platform === 'win32') {
+      return 'mcpslim-windows-x64.exe';
+    } else if (platform === 'darwin') {
+      return arch === 'arm64' ? 'mcpslim-darwin-arm64' : 'mcpslim-darwin-x64';
+    } else {
+      return 'mcpslim-linux-x64';
+    }
+  }
+
+  const binName = getBinaryName();
+  const mcpslimBin = path.join(__dirname, 'bin', binName);
+  const recipePath = path.join(__dirname, 'recipes', 'sqlite.json');
+
+  // 원본 MCP 명령어
+  const originalMcp = process.env.MCPSLIM_ORIGINAL_MCP?.split(' ')
+    || ["uvx","mcp-server-sqlite"];
+
+  const bridgeArgs = ['bridge', '--recipe', recipePath, '--', ...originalMcp];
+
+  const child = spawn(mcpslimBin, bridgeArgs, {
+    stdio: 'inherit',
+    windowsHide: true
+  });
+
+  child.on('error', (err) => {
+    console.error('Failed to start MCPSlim:', err.message);
+    process.exit(1);
+  });
+
+  child.on('exit', (code) => process.exit(code || 0));
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "sqlite-slim",
+  "version": "0.0.2-slim.1.9",
+  "description": "sqlite MCP (33% less tokens). Quick setup: npx sqlite-slim --setup",
+  "bin": {
+    "sqlite-slim": "./index.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "gemini",
+    "chatgpt",
+    "sqlite",
+    "slim",
+    "token-reduction"
+  ],
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "bin/",
+    "recipes/",
+    "index.js",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/palan-k/mcpslim.git",
+    "directory": "packages/sqlite-slim"
+  },
+  "mcpslim": {
+    "originalPackage": "mcp-server-sqlite",
+    "originalVersion": "0.0.2",
+    "originalTools": 6,
+    "slimTools": 4,
+    "tokenReduction": "33%"
+  }
+}

package/recipes/sqlite.json

@@ -0,0 +1,77 @@
+{
+  "mcp_name": "sqlite",
+  "auto_generated": true,
+  "algorithm_version": "v2.1",
+  "rules": {
+    "default_minifier": "first_sentence",
+    "remove_params_description": false
+  },
+  "groups": [
+    {
+      "name": "query",
+      "description": "Execute SQL commands to read, add, modify, or remove data within a SQLite database.",
+      "mapping": {
+        "read": "read_query",
+        "write": "write_query"
+      },
+      "common_schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "read",
+              "write"
+            ]
+          },
+          "query": {
+            "type": "string",
+            "description": "SELECT SQL query to execute"
+          }
+        },
+        "required": [
+          "action",
+          "query"
+        ]
+      }
+    },
+    {
+      "name": "table",
+      "description": "Manage SQLite databases by constructing new tables and retrieving their defined column structures.",
+      "mapping": {
+        "create": "create_table",
+        "describe": "describe_table"
+      },
+      "common_schema": {
+        "type": "object",
+        "properties": {
+          "action": {
+            "type": "string",
+            "enum": [
+              "create",
+              "describe"
+            ]
+          },
+          "query": {
+            "type": "string",
+            "description": "CREATE TABLE SQL statement"
+          },
+          "table_name": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "action",
+          "query",
+          "table_name"
+        ]
+      }
+    }
+  ],
+  "passthrough": [
+    "list_tables",
+    "append_insight"
+  ],
+  "ai_enhanced": true,
+  "enhanced_at": "2026-01-20T02:44:45.234Z"
+}