1lev1-mcp 1.0.0

package/README.md

@@ -0,0 +1,67 @@
+# 1lev1 MCP Setup 💗 (English)
+
+A CLI tool to quickly connect the **1lev1** system to your favorite AI agents (Claude Desktop, Cursor, Windsurf, VS Code, etc.) using the MCP (Model Context Protocol).
+
+## Features
+
+By connecting, your AI agent gains "superpowers" within the 1lev1 system:
+
+- 🕒 **Timer Control**: Start, stop, and manage timers in real-time.
+- 🤝 **Partnerships**: Manage and connect different entities in the system.
+- ✅ **Task Management**: Automatically create and track tasks.
+- 📊 **Voting & Sales Data**: Get real-time updates on audience voting and sales reports.
+
+## Installation & Usage
+
+Once the package is published to NPM, no prior installation is needed. Simply run:
+
+```bash
+npx 1lev1-mcp
+```
+
+## Customization (for Developers)
+
+To use this tool for your own MCP project, follow these two simple steps:
+
+1. **Edit Config**: Change the values in `src/app-config.js` to match your service name and server URLs.
+2. **Server-Side Implementation**: Ensure your website has the following routes:
+   - `authUrlBase`: A page for authentication that returns the user to the callback URL with the API Key.
+   - `mcpUrl`: The MCP server endpoint (supporting SSE or Stdio).
+
+---
+
+**1lev1 - we can together 💗**
+
+---
+
+# 1lev1 MCP Setup (Hebrew) 💗
+
+כלי CLI לחיבור מהיר של מערכת **1lev1** לסוכני ה-AI האהובים עליך (Claude Desktop, Cursor, Windsurf, VS Code ועוד) באמצעות פרוטוקול MCP (Model Context Protocol).
+
+## מה זה מאפשר?
+
+באמצעות החיבור, סוכן ה-AI שלך מקבל יכולות "על" בתוך המערכת של 1lev1:
+
+- 🕒 **שליטה בטיימרים**: הפעלה, עצירה וניהול זמן בזמן אמת.
+- 🤝 **יצירת שותפויות**: ניהול וחיבור גורמים שוני במערכת.
+- ✅ **ניהול משימות**: יצירה ומעקב אחר משימות בצורה אוטובטית.
+- 📊 **נתוני הצבעות ומכירות**: קבלת מידע מעודכן על הצבעות קהל ודו"חות מכירה.
+
+## התקנה ושימוש
+
+ברגע שהחבילה מפורסמת ב-NPM, אין צורך בהתקנה מוקדמת. פשוט הריצו:
+
+```bash
+npx 1lev1-mcp
+```
+
+## התאמה אישית (למפתחים)
+
+אם ברצונך להשתמש בכלי זה עבור פרויקט MCP משלך, עליך לבצע שני פעולות פשוטות:
+
+1. **עריכת הקונפיג**: שנה את הערכים ב-`src/app-config.js` כדי שיתאימו לשם השירות ולכתובות ה-URL של השרת שלך.
+2. **מימוש בצד השרת**: עליך לוודא שבאתר שלך קיימים הראוטים (Routes) הבאים:
+   - `authUrlBase`: דף שמבצע אימות ומחזיר את המשתמש לכתובת ה-callback עם ה-API Key.
+   - `mcpUrl`: נקודת הקצה (Endpoint) של שרת ה-MCP שתומכת ב-SSE או ב-Stdio.
+
+---

package/bin/cli.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { runSetup } from '../src/auth-flow.js';
+import { APP_CONFIG } from '../src/app-config.js';
+
+const program = new Command();
+
+program
+    .name(APP_CONFIG.serviceName)
+    .description('Connect your MCP server to AI coding agents')
+    .version('1.0.0');
+
+program
+    .command('setup', { isDefault: true })
+    .description('Authenticate and configure all supported agents')
+    .option('--url <url>', 'MCP server URL', APP_CONFIG.mcpUrl)
+    .option('--port <port>', 'Local callback port', APP_CONFIG.defaultPort.toString())
+    .action(runSetup);
+
+program.parse();

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "1lev1-mcp",
+  "version": "1.0.0",
+  "description": "Connect 1lev1 to your AI coding agents",
+  "type": "module",
+  "bin": {
+    "1lev1-mcp": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": ["mcp", "ai", "claude", "cursor"],
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0",
+    "open": "^10.0.0",
+    "chalk": "^5.0.0",
+    "ora": "^8.0.0"
+  },
+  "engines": { "node": ">=18" }
+}

package/src/app-config.js

@@ -0,0 +1,13 @@
+export const APP_CONFIG = {
+    // שם השירות כפי שיופיע בקונפיג של הסוכנים (Claude, Cursor וכו')
+    serviceName: '1lev1-mcp',
+    
+    // כתובת ה-URL של ה-MCP server
+    mcpUrl: 'https://1lev1.com/api/mcp',
+    
+    // כתובת דף החיבור באתר (עבור OAuth/Auth flow)
+    authUrlBase: 'https://1lev1.com/mcp-connect',
+    
+    // פורט ברירת מחדל לשרת ה-callback המקומי
+    defaultPort: 4242
+};

package/src/auth-flow.js

@@ -0,0 +1,73 @@
+import http from 'node:http';
+import open from 'open';
+import chalk from 'chalk';
+import ora from 'ora';
+import { writeAllConfigs } from './config-writers.js';
+import { APP_CONFIG } from './app-config.js';
+
+export async function runSetup({ url, port }) {
+    console.log(chalk.bold('\n  MCP Setup ' + url + ' ' + port + '\n'));
+
+    // 1. מפעיל שרת — מחזיר promise בלי לחכות עליו עדיין
+    const { promise: apiKeyPromise } = startCallbackServer(Number(port));
+
+    // 2. רק עכשיו פותח דפדפן
+    const authUrl = new URL(APP_CONFIG.authUrlBase);
+    authUrl.searchParams.set('callback', `http://localhost:${port}/callback`);
+
+    const spinner = ora('Opening browser...').start();
+    await open(authUrl.toString());
+    spinner.text = 'Waiting for authentication in browser...';
+
+    // 3. עכשיו מחכה
+    const key = await apiKeyPromise;
+    spinner.succeed(chalk.green('Authenticated!'));
+
+    const writeSpinner = ora('Writing agent configs...').start();
+    const results = await writeAllConfigs({ mcpUrl: url, apiKey: key });
+    writeSpinner.stop();
+
+    for (const [agent, status] of Object.entries(results)) {
+        const icon = status.success ? chalk.green('✓') : chalk.yellow('–');
+        const msg = status.success ? chalk.dim(status.path) : chalk.dim(status.reason);
+        console.log(`  ${icon}  ${agent.padEnd(18)} ${msg}`);
+    }
+
+    console.log('\n' + chalk.bold('  Done!') + ' Restart your agent to pick up the new config.\n');
+}
+
+// נפרד מ-waitForCallback — מחזיר { promise } בלי await
+function startCallbackServer(port) {
+    const promise = new Promise((resolve, reject) => {
+        const server = http.createServer((req, res) => {
+            const url = new URL(req.url, `http://localhost:${port}`);
+            if (url.pathname !== '/callback') { res.writeHead(404); res.end(); return; }
+
+            const apiKey = url.searchParams.get('api_key');
+            if (!apiKey) { res.writeHead(400); res.end('Missing api_key'); return; }
+
+            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+            res.end(`<!DOCTYPE html><html><head><meta charset="utf-8">
+        <style>body{font-family:system-ui;display:flex;align-items:center;
+        justify-content:center;height:100vh;margin:0;background:#f9f9f7}
+        .card{text-align:center;padding:2rem 3rem;border-radius:16px;
+        background:#fff;box-shadow:0 2px 16px #0001}</style>
+        </head><body><div class="card">
+        <h2>✓ Connected!</h2>
+         <b>1💗1 - we can together</b>
+        <p>You can close this tab and return to your terminal.</p>
+        </div></body></html>`);
+
+            server.close();
+            resolve(apiKey);
+        });
+
+        server.listen(port, '127.0.0.1', () => {
+            console.log(chalk.dim(`  Listening on http://localhost:${port}/callback`));
+        });
+        server.on('error', reject);
+        setTimeout(() => { server.close(); reject(new Error('Timed out')); }, 5 * 60 * 1000);
+    });
+
+    return { promise };
+}

package/src/config-writers.js

@@ -0,0 +1,214 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { APP_CONFIG } from './app-config.js';
+
+const HOME = os.homedir();
+
+// כל agent — איפה הקונפיג שלו ואיך נראה הפורמט
+const AGENTS = {
+    'Claude Desktop': {
+        paths: {
+            darwin: path.join(HOME, 'Library/Application Support/Claude/claude_desktop_config.json'),
+            win32: path.join(process.env.APPDATA ?? '', 'Claude', 'claude_desktop_config.json'),
+            linux: path.join(HOME, '.config/claude/claude_desktop_config.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config.mcpServers ??= {};
+            config.mcpServers[name] = {
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+
+    'Cursor': {
+        paths: {
+            darwin: path.join(HOME, '.cursor/mcp.json'),
+            win32: path.join(HOME, '.cursor/mcp.json'),
+            linux: path.join(HOME, '.cursor/mcp.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config.mcpServers ??= {};
+            config.mcpServers[name] = {
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+
+    'Windsurf': {
+        paths: {
+            darwin: path.join(HOME, '.codeium/windsurf/mcp_config.json'),
+            win32: path.join(HOME, '.codeium/windsurf/mcp_config.json'),
+            linux: path.join(HOME, '.codeium/windsurf/mcp_config.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config.mcpServers ??= {};
+            config.mcpServers[name] = {
+                serverUrl: mcpUrl,          // Windsurf משתמש ב-serverUrl
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+
+    'Claude Code': {
+        // על פי הדוקומנטציה הרשמית, ההגדרות נשמרות בקובץ .claude.json בתיקיית הבית
+        paths: {
+            darwin: path.join(HOME, '.claude.json'),
+            win32: path.join(HOME, '.claude.json'),
+            linux: path.join(HOME, '.claude.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            // אנחנו שומרים תחת אובייקט mcpServers הראשי (User Scope - גלובלי)
+            config.mcpServers ??= {};
+            config.mcpServers[name] = {
+                type: 'http', // חובה ב-Claude Code להגדיר סוג חיבור
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+    'Antigravity': {
+        paths: {
+            darwin: path.join(HOME, '.gemini/antigravity/mcp_config.json'),
+            win32: path.join(HOME, '.gemini/antigravity/mcp_config.json'),
+            linux: path.join(HOME, '.gemini/antigravity/mcp_config.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config.mcpServers ??= {};
+            config.mcpServers[name] = {
+                serverUrl: mcpUrl, // Antigravity משתמש ב-serverUrl לחיבור מרוחק
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+    'VS Code': {
+        // VS Code MCP כותב לworkspace — נכתוב ל-global settings
+        paths: {
+            darwin: path.join(HOME, 'Library/Application Support/Code/User/settings.json'),
+            win32: path.join(process.env.APPDATA ?? '', 'Code', 'User', 'settings.json'),
+            linux: path.join(HOME, '.config/Code/User/settings.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config['mcp.servers'] ??= {};
+            config['mcp.servers'][name] = {
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+    'OpenClaw': {
+        paths: {
+            darwin: path.join(HOME, '.openclaw/config.json'),
+            win32: path.join(HOME, '.openclaw/config.json'), // בחלונות זה לרוב גם בתיקיית הבית
+            linux: path.join(HOME, '.openclaw/config.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            // האובייקט של OpenClaw בנוי בצורה מקוננת: config.mcp.servers
+            config.mcp ??= {};
+            config.mcp.servers ??= {};
+
+            config.mcp.servers[name] = {
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+
+    'Cline': {
+        paths: {
+            darwin: path.join(HOME, 'Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'),
+            win32: path.join(process.env.APPDATA ?? '', 'Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'),
+            linux: path.join(HOME, '.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config.mcpServers ??= {};
+            config.mcpServers[name] = {
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+
+    'Roo Code': {
+        paths: {
+            darwin: path.join(HOME, 'Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json'),
+            win32: path.join(process.env.APPDATA ?? '', 'Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json'),
+            linux: path.join(HOME, '.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config.mcpServers ??= {};
+            config.mcpServers[name] = {
+                url: mcpUrl,
+                headers: { Authorization: `Bearer ${apiKey}` },
+            };
+            return config;
+        },
+    },
+
+    'Continue': {
+        paths: {
+            darwin: path.join(HOME, '.continue/config.json'),
+            win32: path.join(HOME, '.continue/config.json'),
+            linux: path.join(HOME, '.continue/config.json'),
+        },
+        write: (config, { mcpUrl, apiKey, name }) => {
+            config.mcpServers ??= {};
+            // Continue.dev משתמש במבנה מעט שונה המגדיר transport
+            config.mcpServers[name] = {
+                transport: {
+                    type: "sse",
+                    url: mcpUrl,
+                    headers: { Authorization: `Bearer ${apiKey}` }
+                }
+            };
+            return config;
+        },
+    },
+
+};
+
+export async function writeAllConfigs({ mcpUrl, apiKey, name = APP_CONFIG.serviceName }) {
+    const platform = process.platform;
+    const results = {};
+
+    for (const [agentName, agent] of Object.entries(AGENTS)) {
+        const filePath = agent.paths[platform] ?? agent.paths['linux'];
+
+        try {
+            // קורא קונפיג קיים (אם יש) או מתחיל ריק
+            let config = {};
+            if (fs.existsSync(filePath)) {
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                try {
+                    config = JSON.parse(raw);
+                } catch (parseError) {
+                    // טיפול למקרה שיש הערות בקובץ JSON (קורה הרבה ב-VS Code)
+                    console.warn(`[Warning] Could not parse JSON for ${agentName}. Creating new config. Error: ${parseError.message}`);
+                }
+            }
+
+            // מעדכן
+            config = agent.write(config, { mcpUrl, apiKey, name });
+
+            // כותב בחזרה
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, JSON.stringify(config, null, 2), 'utf-8');
+
+            results[agentName] = { success: true, path: filePath };
+        } catch (err) {
+            results[agentName] = { success: false, reason: err.message };
+        }
+    }
+
+    return results;
+}