nexus-mcp-agent 0.1.2

package/dist/tools/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/web/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAwLtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAmChF"}

package/dist/tools/web/index.js

@@ -0,0 +1,193 @@
+import { z } from 'zod/v3';
+import axios from 'axios';
+import * as cheerio from 'cheerio';
+import { createContextLogger } from '../../core/logger.js';
+import { nexusConfig } from '../../core/config.js';
+const log = createContextLogger('tools/web');
+const WebSearchSchema = z.object({
+    query: z.string().describe('Search query'),
+    maxResults: z.number().optional().default(10).describe('Maximum number of results'),
+});
+const WebBrowseSchema = z.object({
+    url: z.string().describe('URL to browse'),
+    actions: z.string().optional().describe('JavaScript code to execute on the page'),
+    waitFor: z.number().optional().default(2000).describe('Time to wait after page load (ms)'),
+});
+const WebScrapeSchema = z.object({
+    url: z.string().describe('URL to scrape'),
+    selector: z.string().optional().describe('CSS selector to extract specific content'),
+});
+const ApiCallSchema = z.object({
+    method: z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH']).describe('HTTP method'),
+    url: z.string().describe('API endpoint URL'),
+    headers: z.record(z.string()).optional().describe('HTTP headers'),
+    body: z.any().optional().describe('Request body'),
+});
+async function webSearch(params) {
+    const { query, maxResults = 10 } = params;
+    log.info(`Web search: "${query}"`);
+    if (nexusConfig.search.braveApiKey) {
+        try {
+            const response = await axios.get('https://api.search.brave.com/res/v1/web/search', {
+                params: { q: query, count: maxResults },
+                headers: { 'X-Subscription-Token': nexusConfig.search.braveApiKey },
+                timeout: 15000,
+            });
+            return {
+                success: true,
+                provider: 'brave',
+                results: response.data.web?.results?.map((r) => ({
+                    title: r.title,
+                    url: r.url,
+                    snippet: r.description,
+                })) || [],
+            };
+        }
+        catch (error) {
+            log.warn('Brave search failed, falling back to DuckDuckGo');
+        }
+    }
+    try {
+        const response = await axios.get('https://html.duckduckgo.com/html/', {
+            params: { q: query },
+            headers: { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36' },
+            timeout: 15000,
+        });
+        const $ = cheerio.load(response.data);
+        const results = [];
+        $('.result').slice(0, maxResults).each((_, el) => {
+            const title = $(el).find('.result__title a').text().trim();
+            const url = $(el).find('.result__url').text().trim();
+            const snippet = $(el).find('.result__snippet').text().trim();
+            if (title && url) {
+                results.push({ title, url: url.startsWith('http') ? url : `https://${url}`, snippet });
+            }
+        });
+        return { success: true, provider: 'duckduckgo', results };
+    }
+    catch (error) {
+        return { success: false, error: error.message };
+    }
+}
+async function webBrowse(params) {
+    const { url, actions, waitFor = 2000 } = params;
+    log.info(`Browsing: ${url}`);
+    try {
+        const { chromium } = await import('playwright');
+        const browser = await chromium.launch({ headless: nexusConfig.browser.headless });
+        const page = await browser.newPage();
+        await page.goto(url, { waitUntil: 'domcontentloaded', timeout: nexusConfig.browser.timeout });
+        if (waitFor > 0)
+            await page.waitForTimeout(waitFor);
+        if (actions) {
+            try {
+                const actionFn = new Function('page', actions);
+                await actionFn(page);
+            }
+            catch (err) {
+                log.warn(`Action execution failed: ${err.message}`);
+            }
+        }
+        const title = await page.title();
+        const content = await page.content();
+        const text = await page.evaluate(`document.body?.innerText || ''`);
+        const snapshot = await page.accessibility.snapshot();
+        await browser.close();
+        return {
+            success: true,
+            url,
+            title,
+            text: text.slice(0, 50000),
+            accessibilityTree: snapshot,
+        };
+    }
+    catch (error) {
+        return { success: false, error: error.message };
+    }
+}
+async function webScrape(params) {
+    const { url, selector } = params;
+    log.info(`Scraping: ${url}`);
+    try {
+        const response = await axios.get(url, {
+            headers: { 'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36' },
+            timeout: 15000,
+        });
+        const $ = cheerio.load(response.data);
+        $('script, style, nav, footer, header').remove();
+        let content = '';
+        if (selector) {
+            content = $(selector).text();
+        }
+        else {
+            content = $('body').text();
+        }
+        content = content.replace(/\s+/g, ' ').trim();
+        return {
+            success: true,
+            url,
+            content: content.slice(0, 100000),
+        };
+    }
+    catch (error) {
+        return { success: false, error: error.message };
+    }
+}
+async function apiCall(params) {
+    const { method, url, headers, body } = params;
+    log.info(`API call: ${method} ${url}`);
+    try {
+        const response = await axios({
+            method: method,
+            url,
+            headers,
+            data: body,
+            timeout: 30000,
+        });
+        return {
+            success: true,
+            status: response.status,
+            headers: response.headers,
+            data: response.data,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            status: error.response?.status,
+            error: error.message,
+        };
+    }
+}
+export function registerWebTools(server, registry) {
+    server.registerTool('web_search', {
+        description: 'Search the web for information',
+        inputSchema: WebSearchSchema,
+    }, async (params) => ({
+        content: [{ type: 'text', text: JSON.stringify(await webSearch(params), null, 2) }],
+    }));
+    server.registerTool('web_browse', {
+        description: 'Browse a webpage with Playwright and extract content',
+        inputSchema: WebBrowseSchema,
+    }, async (params) => ({
+        content: [{ type: 'text', text: JSON.stringify(await webBrowse(params), null, 2) }],
+    }));
+    server.registerTool('web_scrape', {
+        description: 'Scrape content from a webpage',
+        inputSchema: WebScrapeSchema,
+    }, async (params) => ({
+        content: [{ type: 'text', text: JSON.stringify(await webScrape(params), null, 2) }],
+    }));
+    server.registerTool('api_call', {
+        description: 'Make HTTP API calls (REST/GraphQL)',
+        inputSchema: ApiCallSchema,
+    }, async (params) => ({
+        content: [{ type: 'text', text: JSON.stringify(await apiCall(params), null, 2) }],
+    }));
+    registry.register({ name: 'web_search', category: 'web', description: 'Search the web', handler: webSearch });
+    registry.register({ name: 'web_browse', category: 'web', description: 'Browse webpage', handler: webBrowse });
+    registry.register({ name: 'web_scrape', category: 'web', description: 'Scrape webpage', handler: webScrape });
+    registry.register({ name: 'api_call', category: 'web', description: 'HTTP API call', handler: apiCall });
+    log.info('Registered 4 web tools');
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/web/index.js.map

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

package/docs/SECURITY.md

@@ -0,0 +1,31 @@
+# 🔒 Security Policy
+
+NEXUS is an autonomous AI agent with broad system access. Security is paramount.
+
+## Security Layers
+
+### 1. Path Restrictions
+All file operations are restricted to `ALLOWED_DIRS`.
+
+### 2. Command Blocking
+Dangerous commands blocked: `rm -rf /`, `format`, `mkfs`, etc.
+
+### 3. Audit Logging
+Sensitive ops logged to `logs/audit.log`.
+
+### 4. Confirmation for Destructive Actions
+Marked tools can require confirmation.
+
+### 5. Network Isolation
+Web operations respect system proxy settings.
+
+## Best Practices
+
+1. Start with narrow `ALLOWED_DIRS`
+2. Monitor `logs/audit.log`
+3. Store API keys in `.env` (never commit)
+4. Run in isolated environment
+5. Limit network access with firewalls
+
+## Disclaimer
+NEXUS is provided as-is. User is responsible for securing API keys, configuring permissions, and monitoring activity.

package/mcp-config.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "nexus": {
+      "command": "npx",
+      "args": ["-y", "nexus-mcp-agent"],
+      "env": {}
+    }
+  }
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "nexus-mcp-agent",
+  "version": "0.1.2",
+  "description": "Autonomous AI Agent MCP Server — no API keys required, works out of the box",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "nexus": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts",
+    "setup": "node scripts/setup.js",
+    "chroma": "docker run -p 8000:8000 chromadb/chroma",
+    "clean": "rmdir /s /q node_modules && del package-lock.json"
+  },
+  "keywords": [
+    "mcp",
+    "ai-agent",
+    "autonomous",
+    "claude",
+    "anthropic"
+  ],
+  "author": "Qwen AI (self-built)",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "playwright": "^1.49.0",
+    "sql.js": "^1.11.0",
+    "zod": "^3.23.8",
+    "zod-to-json-schema": "^3.23.5",
+    "node-cron": "^3.0.3",
+    "chokidar": "^4.0.1",
+    "chromadb": "^1.9.2",
+    "chromadb-default-embed": "^2.13.2",
+    "axios": "^1.7.9",
+    "cheerio": "^1.0.0",
+    "simple-git": "^3.27.0",
+    "dotenv": "^16.4.5",
+    "pino": "^9.5.0",
+    "pino-pretty": "^13.0.0",
+    "execa": "^9.5.2",
+    "openai": "^4.73.1",
+    "@anthropic-ai/sdk": "^0.32.1",
+    "uuid": "^11.0.3",
+    "glob": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.9.3",
+    "@types/node-cron": "^3.0.11",
+    "@types/uuid": "^10.0.0",
+    "@types/sql.js": "^1.4.9",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.5",
+    "eslint": "^9.15.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/scripts/setup.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, copyFileSync, writeFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = resolve(__dirname, '..');
+
+console.log('NEXUS - Autonomous AI Agent Ecosystem');
+console.log('========================================\n');
+
+console.log('Creating directories...');
+const dirs = ['data', 'logs', 'workspace', 'skills', 'data/memory'];
+dirs.forEach(dir => {
+  const fullPath = resolve(rootDir, dir);
+  if (!existsSync(fullPath)) {
+    mkdirSync(fullPath, { recursive: true });
+    console.log(`  Created: ${dir}`);
+  } else {
+    console.log(`  Exists: ${dir}`);
+  }
+});
+
+console.log('\nSetting up environment...');
+const envExample = resolve(rootDir, '.env.example');
+const envFile = resolve(rootDir, '.env');
+
+if (!existsSync(envFile) && existsSync(envExample)) {
+  copyFileSync(envExample, envFile);
+  console.log('  Created .env from .env.example');
+  console.log('  Please edit .env to add your API keys');
+} else if (existsSync(envFile)) {
+  console.log('  .env already exists');
+}
+
+console.log('\nChecking Node.js version...');
+const nodeVersion = process.versions.node;
+const [major] = nodeVersion.split('.').map(Number);
+if (major < 20) {
+  console.log(`  Node.js ${nodeVersion} detected - requires 20+`);
+  console.log('  Please upgrade Node.js: https://nodejs.org/');
+} else {
+  console.log(`  Node.js ${nodeVersion}`);
+}
+
+console.log('\nChecking npm...');
+try {
+  const npmVersion = execSync('npm --version', { encoding: 'utf-8' }).trim();
+  console.log(`  npm ${npmVersion}`);
+} catch {
+  console.log('  npm not found');
+}
+
+console.log('\nChecking Docker (optional)...');
+try {
+  const dockerVersion = execSync('docker --version', { encoding: 'utf-8' }).trim();
+  console.log(`  ${dockerVersion}`);
+  console.log('  Run: docker run -d -p 8000:8000 chromadb/chroma');
+} catch {
+  console.log('  Docker not found - memory will use in-memory fallback');
+}
+
+console.log('\nInitializing state database...');
+const dbPath = resolve(rootDir, 'data', 'state.sqlite');
+if (!existsSync(dbPath)) {
+  console.log('  state.sqlite will be created on first run');
+} else {
+  console.log('  state.sqlite already exists');
+}
+
+console.log('\nCreating workspace welcome file...');
+const welcomePath = resolve(rootDir, 'workspace', 'WELCOME.md');
+if (!existsSync(welcomePath)) {
+  writeFileSync(welcomePath, `# Welcome to NEXUS Workspace
+
+This is your autonomous AI workspace. NEXUS can read, write, and manage files here.
+
+## Quick Start
+- Use \`fs_read\` to read files
+- Use \`fs_write\` to create/edit files
+- Use \`web_search\` to search the web
+- Use \`memory_store\` to save information for later
+
+## Configuration
+Edit \`.env\` in the NEXUS root to configure API keys and settings.
+
+## Documentation
+See [README.md](../README.md) for full documentation.
+`);
+  console.log('  Created workspace/WELCOME.md');
+}
+
+console.log('\nSetup complete!\n');
+console.log('Next steps:');
+console.log('  1. Edit .env to add your API keys (OPENAI_API_KEY, etc.)');
+console.log('  2. Run: npm install');
+console.log('  3. Run: npm run build');
+console.log('  4. Run: npm start');
+console.log('  5. Add to Claude Desktop config: mcp-config.json\n');

package/src/core/config.ts

@@ -0,0 +1,138 @@
+import { config } from 'dotenv';
+import { resolve } from 'path';
+import { existsSync } from 'fs';
+
+// Load .env file
+const envPath = process.env.NEXUS_CONFIG || resolve(process.cwd(), '.env');
+if (existsSync(envPath)) {
+  config({ path: envPath });
+} else {
+  config();
+}
+
+export interface NexusConfig {
+  // LLM
+  llm: {
+    provider: 'openai' | 'anthropic' | 'ollama';
+    model: string;
+    openaiApiKey?: string;
+    anthropicApiKey?: string;
+    ollamaUrl: string;
+  };
+
+  // Web Search
+  search: {
+    provider: 'brave' | 'google' | 'duckduckgo';
+    braveApiKey?: string;
+  };
+
+  // Vector DB
+  vector: {
+    type: 'chroma-local' | 'chroma-remote' | 'sqlite-vss';
+    chromaUrl: string;
+    collection: string;
+  };
+
+  // State DB
+  state: {
+    dbPath: string;
+  };
+
+  // Directories
+  paths: {
+    workspace: string;
+    data: string;
+    logs: string;
+    skills: string;
+  };
+
+  // Security
+  security: {
+    allowedDirs: string[];
+    blockedCommands: string[];
+    auditLogEnabled: boolean;
+  };
+
+  // Automation
+  automation: {
+    cronEnabled: boolean;
+    watcherEnabled: boolean;
+  };
+
+  // Logging
+  logging: {
+    level: 'debug' | 'info' | 'warn' | 'error';
+  };
+
+  // Browser
+  browser: {
+    headless: boolean;
+    timeout: number;
+  };
+}
+
+function parseBool(val: string | undefined, defaultVal: boolean): boolean {
+  if (!val) return defaultVal;
+  return val.toLowerCase() === 'true' || val === '1';
+}
+
+function parseList(val: string | undefined): string[] {
+  if (!val) return [];
+  return val.split(',').map(s => s.trim()).filter(Boolean);
+}
+
+export const nexusConfig: NexusConfig = {
+  llm: {
+    provider: (process.env.DEFAULT_LLM_PROVIDER as any) || 'openai',
+    model: process.env.DEFAULT_LLM_MODEL || 'gpt-4o',
+    openaiApiKey: process.env.OPENAI_API_KEY,
+    anthropicApiKey: process.env.ANTHROPIC_API_KEY,
+    ollamaUrl: process.env.OLLAMA_BASE_URL || 'http://localhost:11434',
+  },
+
+  search: {
+    provider: (process.env.DEFAULT_SEARCH_PROVIDER as any) || 'duckduckgo',
+    braveApiKey: process.env.BRAVE_SEARCH_API_KEY,
+  },
+
+  vector: {
+    type: (process.env.VECTOR_DB as any) || 'chroma-local',
+    chromaUrl: process.env.CHROMA_URL || 'http://localhost:8000',
+    collection: process.env.CHROMA_COLLECTION || 'nexus_memory',
+  },
+
+  state: {
+    dbPath: process.env.STATE_DB_PATH || './data/state.sqlite',
+  },
+
+  paths: {
+    workspace: process.env.WORKSPACE_DIR || './workspace',
+    data: process.env.DATA_DIR || './data',
+    logs: process.env.LOGS_DIR || './logs',
+    skills: process.env.SKILLS_DIR || './skills',
+  },
+
+  security: {
+    allowedDirs: parseList(process.env.ALLOWED_DIRS) || ['./workspace'],
+    blockedCommands: parseList(process.env.BLOCKED_COMMANDS) || ['rm -rf /'],
+    auditLogEnabled: parseBool(process.env.AUDIT_LOG_ENABLED, true),
+  },
+
+  automation: {
+    cronEnabled: parseBool(process.env.CRON_ENABLED, true),
+    watcherEnabled: parseBool(process.env.WATCHER_ENABLED, true),
+  },
+
+  logging: {
+    level: (process.env.LOG_LEVEL as any) || 'info',
+  },
+
+  browser: {
+    headless: parseBool(process.env.BROWSER_HEADLESS, true),
+    timeout: parseInt(process.env.BROWSER_TIMEOUT || '30000', 10),
+  },
+};
+
+export function validateConfig(): string[] {
+  return [];
+}

package/src/core/logger.ts

@@ -0,0 +1,61 @@
+import pino from 'pino';
+import { resolve } from 'path';
+import { mkdirSync, existsSync } from 'fs';
+import { nexusConfig } from './config.js';
+
+// Ensure logs directory exists
+const logsDir = resolve(nexusConfig.paths.logs);
+if (!existsSync(logsDir)) {
+  mkdirSync(logsDir, { recursive: true });
+}
+
+const logFile = resolve(logsDir, `nexus-${new Date().toISOString().split('T')[0]}.log`);
+
+// Create logger with both console and file transport
+export const logger = pino({
+  level: nexusConfig.logging.level,
+  transport: {
+    targets: [
+      {
+        target: 'pino-pretty',
+        options: {
+          colorize: true,
+          translateTime: 'SYS:standard',
+          ignore: 'pid,hostname',
+        },
+      },
+      {
+        target: 'pino/file',
+        options: {
+          destination: logFile,
+          mkdir: true,
+        },
+      },
+    ],
+  },
+});
+
+export type Logger = typeof logger;
+
+// Create child logger with context
+export function createContextLogger(context: string): Logger {
+  return logger.child({ context });
+}
+
+// Audit logger for security-sensitive operations
+export const auditLogger = pino({
+  level: 'info',
+  transport: {
+    target: 'pino/file',
+    options: {
+      destination: resolve(logsDir, 'audit.log'),
+      mkdir: true,
+    },
+  },
+});
+
+export function logAudit(event: string, details: Record<string, any>): void {
+  if (nexusConfig.security.auditLogEnabled) {
+    auditLogger.info({ event, ...details, timestamp: new Date().toISOString() }, event);
+  }
+}