lantern-connect 0.2.2 → 0.3.0

package/README.md

@@ -34,7 +34,7 @@ lantern-connect --mcp-url https://your-ngrok-url.ngrok-free.dev/mcp
 
 ## What it does
 
-1. **Detects** installed AI tools (Claude Desktop, Claude Code, Gemini CLI, Cursor)
+1. **Detects** installed AI tools (Claude Code, Gemini CLI, Cursor)
 2. **Configures** each detected tool to connect to Lantern's MCP server
 3. **Each tool authenticates** with Lantern on first use (via OAuth)
 
@@ -42,11 +42,18 @@ lantern-connect --mcp-url https://your-ngrok-url.ngrok-free.dev/mcp
 
 | Tool | Config Location | Method |
 |------|-----------------|--------|
-| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` | mcp-remote |
 | Claude Code | `~/.claude.json` | `claude mcp add` |
 | Gemini CLI | `~/.gemini/settings.json` | httpUrl config |
 | Cursor | `~/.cursor/mcp.json` | url config |
 
+### Claude Web & Desktop
+
+For Claude Web and Claude Desktop, use the built-in custom connector:
+
+1. Go to **Settings → Connectors → Add custom connector**
+2. Name it **Lantern** and paste: `https://mcp.onlantern.com/mcp`
+3. Click **Add**, then **Connect**
+
 ## After Installation
 
 1. **Fully quit and reopen** your AI tools (Cmd+Q on macOS)
@@ -62,12 +69,9 @@ lantern-connect --mcp-url https://your-ngrok-url.ngrok-free.dev/mcp
 # Start your local Lantern backend and MCP server
 cd lantern && npm run dev
 
-# Start ngrok to expose MCP server (required for Claude Desktop)
-ngrok http 3002
-
-# Run the CLI with your ngrok URL
+# Run the CLI with your local MCP server
 cd lantern-connect
-node bin/lantern-connect.js --mcp-url https://your-ngrok-url.ngrok-free.dev/mcp
+node bin/lantern-connect.js --mcp-url http://localhost:3002/mcp
 ```
 
 ## Resetting / Uninstall
@@ -78,7 +82,7 @@ To remove Lantern configuration from all AI tools at once:
 npx lantern-reset
 ```
 
-This removes the Lantern MCP server from Claude Desktop, Claude Code, Gemini CLI, and Cursor. Restart your AI tools after running.
+This removes the Lantern MCP server from Claude Code, Gemini CLI, and Cursor. Restart your AI tools after running.
 
 ### Manual Reset
 
@@ -89,11 +93,8 @@ If you prefer to reset manually:
 claude mcp remove lantern
 ```
 
-**Claude Desktop (macOS):**
-```bash
-nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
-# Remove the "lantern" entry from mcpServers, then save
-```
+**Claude Web & Desktop:**
+Go to Settings → Connectors and remove the Lantern connector.
 
 **Gemini CLI:**
 ```bash
@@ -109,10 +110,6 @@ nano ~/.cursor/mcp.json
 
 ## Troubleshooting
 
-### Claude Desktop shows "Server disconnected"
-- Make sure you're using an ngrok URL (Claude Desktop can't reach localhost)
-- Restart Claude Desktop completely (Cmd+Q, not just close window)
-
 ### Gemini CLI shows "Bad Request" for SSE
 - Make sure your backend has the latest MCP session handling code
 - Restart your backend server

package/bin/lantern-reset.js

@@ -2,7 +2,6 @@
 
 import {
   expandHome,
-  getClaudeDesktopConfigPath,
   removeFromJsonConfig,
   clearGeminiOAuthCache,
   removeClaudeCode,
@@ -18,11 +17,6 @@ async function main() {
 
   const results = []
 
-  // Claude Desktop
-  const claudeDesktopPath = getClaudeDesktopConfigPath()
-  const claudeDesktopResult = removeFromJsonConfig(claudeDesktopPath, 'lantern')
-  results.push({ name: 'Claude Desktop', ...claudeDesktopResult, reason: 'not configured' })
-
   // Claude Code
   const claudeCodeResult = removeClaudeCode()
   results.push({ name: 'Claude Code', ...claudeCodeResult, reason: 'not configured' })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lantern-connect",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "CLI installer to connect AI tools (Claude, Gemini, Cursor) to Lantern",
   "type": "module",
   "bin": {

package/src/detect.js

@@ -19,22 +19,6 @@ function commandExists(command) {
   }
 }
 
-function getClaudeDesktopPath() {
-  const os = platform()
-  if (os === 'darwin') {
-    return expandHome('~/Library/Application Support/Claude')
-  } else if (os === 'win32') {
-    return join(process.env.APPDATA || '', 'Claude')
-  } else {
-    // Linux
-    return expandHome('~/.config/Claude')
-  }
-}
-
-function getClaudeDesktopConfigPath() {
-  return join(getClaudeDesktopPath(), 'claude_desktop_config.json')
-}
-
 function getCursorPath() {
   // Cursor uses ~/.cursor for MCP config on all platforms
   return expandHome('~/.cursor')
@@ -49,11 +33,6 @@ function getGeminiConfigPath() {
 }
 
 export const tools = {
-  claudeDesktop: {
-    name: 'Claude Desktop',
-    detect: () => existsSync(getClaudeDesktopPath()),
-    configPath: getClaudeDesktopConfigPath,
-  },
   claudeCode: {
     name: 'Claude Code',
     detect: () => commandExists('claude'),

package/src/index.js

@@ -1,5 +1,4 @@
 import { detectTools, hasAnyTools } from './detect.js'
-import { configureClaudeDesktop } from './configure/claude-desktop.js'
 import { configureClaudeCode } from './configure/claude-code.js'
 import { configureGeminiCli } from './configure/gemini-cli.js'
 import { configureCursor } from './configure/cursor.js'
@@ -8,7 +7,6 @@ import { resetAll } from './reset.js'
 const DEFAULT_MCP_URL = 'https://mcp.onlantern.com/mcp'
 
 const configurators = {
-  claudeDesktop: configureClaudeDesktop,
   claudeCode: configureClaudeCode,
   geminiCli: configureGeminiCli,
   cursor: configureCursor,
@@ -65,11 +63,14 @@ export async function main() {
     console.log('  ⚠️  No supported AI tools found.')
     console.log('')
     console.log('  Supported tools:')
-    console.log('    • Claude Desktop')
     console.log('    • Claude Code (claude CLI)')
     console.log('    • Gemini CLI')
     console.log('    • Cursor')
     console.log('')
+    console.log('  For Claude Desktop or Claude Web, use the custom connector:')
+    console.log('    Settings → Connectors → Add custom connector')
+    console.log('    URL: https://mcp.onlantern.com/mcp')
+    console.log('')
     process.exit(1)
   }
 

package/src/reset.js

@@ -1,5 +1,5 @@
 import { existsSync, readFileSync, writeFileSync } from 'fs'
-import { homedir, platform } from 'os'
+import { homedir } from 'os'
 import { join } from 'path'
 import { execSync } from 'child_process'
 
@@ -10,17 +10,6 @@ function expandHome(path) {
   return path
 }
 
-function getClaudeDesktopConfigPath() {
-  const os = platform()
-  if (os === 'darwin') {
-    return expandHome('~/Library/Application Support/Claude/claude_desktop_config.json')
-  } else if (os === 'win32') {
-    return join(process.env.APPDATA || '', 'Claude', 'claude_desktop_config.json')
-  } else {
-    return expandHome('~/.config/Claude/claude_desktop_config.json')
-  }
-}
-
 function removeFromJsonConfig(configPath, name) {
   if (!existsSync(configPath)) {
     return { found: false }
@@ -84,12 +73,6 @@ function removeClaudeCode() {
 export function resetAll() {
   let anyReset = false
 
-  // Claude Desktop
-  const claudeDesktopPath = getClaudeDesktopConfigPath()
-  if (removeFromJsonConfig(claudeDesktopPath, 'lantern').found) {
-    anyReset = true
-  }
-
   // Claude Code
   if (removeClaudeCode().found) {
     anyReset = true
@@ -116,7 +99,6 @@ export function resetAll() {
 // Export individual functions for lantern-reset CLI
 export {
   expandHome,
-  getClaudeDesktopConfigPath,
   removeFromJsonConfig,
   clearGeminiOAuthCache,
   removeClaudeCode,

package/src/configure/claude-desktop.js

@@ -1,66 +0,0 @@
-import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs'
-import { dirname } from 'path'
-import { execSync } from 'child_process'
-import { tools } from '../detect.js'
-
-function checkNodeVersion() {
-  try {
-    const version = execSync('node -v', { encoding: 'utf-8' }).trim()
-    const major = parseInt(version.slice(1).split('.')[0], 10)
-
-    if (major < 20) {
-      const lines = [
-        `Node.js >= 20 required, but found ${version}`,
-        '',
-        'Claude Desktop uses mcp-remote which requires Node.js 20+.',
-        '',
-        'To fix:',
-        '  • If using nvm: nvm install 20 && nvm alias default 20',
-        '  • Or download from: https://nodejs.org',
-        '',
-        'Then restart your terminal and run lantern-connect again.',
-      ]
-      throw new Error(lines.join('\n'))
-    }
-  } catch (err) {
-    if (err.message.includes('Node.js >= 20')) {
-      throw err
-    }
-    // If node command fails, let it proceed and fail later with a clearer error
-  }
-}
-
-export function configureClaudeDesktop(mcpUrl) {
-  checkNodeVersion()
-  const configPath = tools.claudeDesktop.configPath()
-
-  // Ensure directory exists
-  const configDir = dirname(configPath)
-  if (!existsSync(configDir)) {
-    mkdirSync(configDir, { recursive: true })
-  }
-
-  // Read existing config or create new one
-  let config = {}
-  if (existsSync(configPath)) {
-    try {
-      const content = readFileSync(configPath, 'utf-8')
-      config = JSON.parse(content)
-    } catch {
-      // If file exists but is invalid JSON, start fresh
-      config = {}
-    }
-  }
-
-  // Add/update Lantern MCP server using mcp-remote to bridge HTTP
-  config.mcpServers = config.mcpServers || {}
-  config.mcpServers.lantern = {
-    command: 'npx',
-    args: ['mcp-remote', mcpUrl],
-  }
-
-  // Write config
-  writeFileSync(configPath, JSON.stringify(config, null, 2))
-
-  return configPath
-}