opalserve 0.1.0

package/.env.example

@@ -0,0 +1,19 @@
+# MCP Registry Configuration
+PORT=3000
+HOST=localhost
+LOG_LEVEL=info
+
+# Security
+JWT_SECRET=your-secret-key-change-in-production
+API_KEY=your-api-key
+
+# Server Configurations
+GITHUB_TOKEN=your-github-token
+SLACK_BOT_TOKEN=xoxb-your-slack-token
+POSTGRES_URL=postgresql://localhost:5432/mcp
+GOOGLE_SERVICE_ACCOUNT=./config/google-service-account.json
+
+# Registry Settings
+MAX_TOOLS_PER_RESPONSE=50
+CONTEXT_TOKEN_BUDGET=128000
+ENABLE_AUTH=false

package/AGENTS.md

@@ -0,0 +1,23 @@
+Great — here's the full architect's breakdown. Let me start with the conceptual foundation, then get concrete on building.
+
+---
+
+**What MCP actually is (no fluff):**
+
+MCP was introduced by Anthropic in November 2024 as an open standard to solve the "N×M" integration problem — before MCP, developers had to build a custom connector for every combination of AI model and data source. It's a client-server protocol where the AI model acts as the MCP client, and tools/databases/APIs act as MCP servers. Communication follows JSON-RPC 2.0 over either stdio for local processes or HTTP with Server-Sent Events for remote servers.
+
+The current MCP spec focuses on "Host-to-Server" communication. The next frontier — which is exactly what your project targets — is "Agent-to-Agent" communication.
+
+The enterprise pain points are real: context bloat when thousands of tools must be loaded into an agent's window, missing identity standards for fine-grained authorization, and the "Confused Deputy" security problem where malicious prompts can trick an agent into doing unauthorized actions. These are exactly the gaps your interop layer would solve.Here's a full architecture diagram showing how MCP works today, and where your interop bridge layer fits on top of it:Now here's the concrete build roadmap — broken into 3 phases with exact tech choices and the UI mockup of the visual workflow builder:---
+
+Here's the thing that makes this project genuinely timely as of April 7, 2026:
+
+The most consequential MCP development in 2026 isn't in the spec itself — it's the governance transfer to the Linux Foundation's Agentic AI Foundation. The USB-C analogy is apt but incomplete: USB-C works because no single manufacturer controls the spec. Protocols that stay with their original creator follow a predictable path where the spec evolves to match the company's product roadmap. This transfer means MCP is becoming a true open standard — and the tooling ecosystem above it is wide open.
+
+MCP's 2026 roadmap has maintainers turning attention to what needs to be fixed before the protocol can hold up in real production use — and the exact gaps (auth, agent-to-agent discovery, governance) are precisely what your bridge layer fills.
+
+Tools represent 99% of tracked MCP client adoption — but the enterprise pain points remain: context bloat from loading all tool definitions at once, no standardized user identity propagation, and the "Confused Deputy" security problem where malicious prompts can trick agents into unauthorized actions.
+
+**The business angle is real too:** the enterprise agentic AI market has reached $7.51 billion in 2026, with 40% of all enterprise software now featuring deeply integrated task-specific AI agents — and 72% of organizations report a critical shortage of "agentic engineers" who can actually architect autonomous workflows. Your visual workflow builder directly addresses that shortage by making agentic systems accessible to non-engineers.
+
+The fastest path to a working demo is: start with Phase 1 only (the registry + discovery endpoint), point it at 5 real MCP servers (GitHub, Slack, Postgres, Google Drive, a custom one you write), and build a small CLI tool that shows an agent asking "what can I do?" and getting back a smart, context-sized answer. That demo alone is shareable and technically impressive. Want me to write the actual code for Phase 1 right now?

package/README.md

@@ -0,0 +1,109 @@
+# Nexus
+
+**MCP Tool Registry & Discovery Hub for Enterprise AI Agents**
+
+Nexus solves the "N×M" integration problem in AI agent tooling. Instead of building custom connectors for every AI model and tool combination, Nexus provides a centralized registry with intelligent, context-sized tool discovery.
+
+## Features
+
+- **Intelligent Discovery**: Context-sized responses with relevance scoring
+- **5 Pre-built Connectors**: GitHub, Slack, PostgreSQL, Google Drive, Custom
+- **40+ Tools**: Ready-to-use MCP tools with full schema documentation
+- **Security First**: JWT auth, fine-grained authorization, Confused Deputy prevention
+- **Zero-Dependency HTTP**: Uses native Node.js fetch (no axios - security fix!)
+
+## Quick Start
+
+```bash
+# Install dependencies
+pnpm install
+
+# Configure environment
+cp .env.example .env
+# Edit .env with your tokens
+
+# Start the registry
+pnpm start
+
+# Discover available tools
+pnpm discover "what can I do?"
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        N E X U S                            │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────────────┐│
+│  │  Discovery  │  │    Auth &   │  │   Tool Registry     ││
+│  │  Endpoint   │──│ Authorization│──│  & Indexing         ││
+│  └─────────────┘  └─────────────┘  └─────────────────────┘│
+└─────────────────────────────────────────────────────────────┘
+         │                  │                    │
+         ▼                  ▼                    ▼
+┌─────────────┐    ┌─────────────┐      ┌─────────────┐
+│  GitHub     │    │   Slack     │      │  PostgreSQL │
+│  Connector  │    │  Connector  │      │  Connector  │
+└─────────────┘    └─────────────┘      └─────────────┘
+         │                  │                    │
+         ▼                  ▼                    ▼
+┌─────────────┐    ┌─────────────┐      ┌─────────────┐
+│ Google Drive│    │   Custom     │      │    More...   │
+│  Connector │    │  Connector   │      │              │
+└─────────────┘    └─────────────┘      └─────────────┘
+```
+
+## API Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | `/api/v1/health` | Health check |
+| GET | `/api/v1/discover?query=<text>` | Discover available tools |
+| GET | `/api/v1/tools` | List all registered tools |
+| GET | `/api/v1/tools/:id` | Get specific tool details |
+| GET | `/api/v1/servers` | List registered MCP servers |
+| POST | `/api/v1/servers/register` | Register a new MCP server |
+| POST | `/api/v1/auth/token` | Generate JWT token |
+
+## Discovery Query Examples
+
+```bash
+# What can I do with GitHub?
+nexus-discover "github repository"
+
+# Find messaging tools
+nexus-discover "slack message channel"
+
+# Database operations
+nexus-discover "postgres query database"
+
+# File operations
+nexus-discover "google drive files"
+
+# Custom HTTP operations
+nexus-discover "http request webhook"
+```
+
+## Security
+
+- **JWT Authentication**: Secure agent identity propagation
+- **Fine-grained Authorization**: Permission-based access control
+- **Confused Deputy Prevention**: Prevents malicious prompt injection
+- **No External HTTP Dependencies**: Uses native Node.js fetch (post-axios vulnerability)
+
+## Environment Variables
+
+```env
+PORT=3000
+HOST=localhost
+JWT_SECRET=your-secret-key
+GITHUB_TOKEN=ghp_xxx
+SLACK_BOT_TOKEN=xoxb-xxx
+POSTGRES_URL=postgresql://...
+GOOGLE_SERVICE_ACCOUNT=./config/google-service-account.json
+ENABLE_AUTH=false
+```
+
+## License
+
+MIT

package/config/servers.example.yaml

@@ -0,0 +1,67 @@
+# MCP Interoperability Layer - Server Configuration
+# This file defines the MCP servers to register with the registry
+
+servers:
+  - id: github
+    name: GitHub
+    type: github
+    enabled: true
+    description: GitHub MCP server for repository, issue, and PR management
+    auth:
+      type: api-key
+      envVar: GITHUB_TOKEN
+    tags:
+      - repository
+      - github
+      - code
+
+  - id: slack
+    name: Slack
+    type: slack
+    enabled: true
+    description: Slack MCP server for messaging and channel management
+    auth:
+      type: api-key
+      envVar: SLACK_BOT_TOKEN
+    tags:
+      - messaging
+      - slack
+      - notifications
+
+  - id: postgres
+    name: PostgreSQL
+    type: postgres
+    enabled: true
+    description: PostgreSQL MCP server for database operations
+    auth:
+      type: none
+      envVar: POSTGRES_URL
+    tags:
+      - database
+      - postgres
+      - sql
+
+  - id: google-drive
+    name: Google Drive
+    type: google-drive
+    enabled: true
+    description: Google Drive MCP server for file management
+    auth:
+      type: oauth
+      envVar: GOOGLE_SERVICE_ACCOUNT
+    tags:
+      - files
+      - google
+      - documents
+
+  - id: custom
+    name: Custom Tools
+    type: custom
+    enabled: true
+    description: Custom HTTP and webhook tools
+    auth:
+      type: none
+    tags:
+      - custom
+      - http
+      - webhooks

package/config/servers.yaml

@@ -0,0 +1,2 @@
+# Copy this file to config/servers.yaml and customize
+servers: []

package/dist/cli/discover.d.ts

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

package/dist/cli/discover.d.ts.map

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

package/dist/cli/discover.js

@@ -0,0 +1,160 @@
+#!/usr/bin/env node
+import chalk from 'chalk';
+import ora from 'ora';
+import inquirer from 'inquirer';
+const DEFAULT_REGISTRY_URL = 'http://localhost:3000';
+async function httpGet(url, timeout = 10000) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeout);
+    try {
+        const response = await fetch(url, { signal: controller.signal });
+        clearTimeout(timeoutId);
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        if (error instanceof Error) {
+            if (error.name === 'AbortError') {
+                throw new Error('Request timeout');
+            }
+            throw error;
+        }
+        throw error;
+    }
+}
+async function discover(query, options) {
+    const url = options.registryUrl || DEFAULT_REGISTRY_URL;
+    const spinner = ora('Discovering available tools...').start();
+    try {
+        const params = new URLSearchParams();
+        params.append('query', query);
+        if (options.limit)
+            params.append('limit', String(options.limit));
+        const result = await httpGet(`${url}/api/v1/discover?${params}`);
+        spinner.succeed();
+        return result;
+    }
+    catch (error) {
+        spinner.fail();
+        if (error instanceof Error) {
+            if (error.message.includes('ECONNREFUSED') || error.message.includes('fetch')) {
+                console.error(chalk.red(`\nError: Cannot connect to registry at ${url}`));
+                console.log(chalk.yellow('\nMake sure the registry is running:'));
+                console.log(chalk.cyan('   nexus start\n'));
+            }
+            else {
+                console.error(chalk.red(`\nError: ${error.message}`));
+            }
+        }
+        throw error;
+    }
+}
+function formatResults(result, json) {
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(chalk.bold('\n🔍 Query Interpretation:'));
+    console.log(`   ${result.queryInterpretation}\n`);
+    console.log(chalk.bold(`📊 Found ${result.totalMatches} matching tools`));
+    console.log(chalk.gray(`   Context used: ${result.contextUsed} / ${result.contextBudget} tokens\n`));
+    if (result.tools.length === 0) {
+        console.log(chalk.yellow('No tools matched your query. Try a different search term.'));
+        return;
+    }
+    console.log(chalk.bold('\n🛠️  Available Tools:\n'));
+    for (const { tool, relevanceScore, matchReasons } of result.tools) {
+        const scoreColor = relevanceScore > 0.7 ? 'green' : relevanceScore > 0.4 ? 'yellow' : 'gray';
+        console.log(`  ${chalk[scoreColor](`[${Math.round(relevanceScore * 100)}%]`)} ${chalk.cyan(tool.name)}`);
+        console.log(`     ${tool.description}`);
+        console.log(`     ${chalk.gray('Server:')} ${chalk.white(tool.serverName)}`);
+        if (tool.tags.length > 0) {
+            console.log(`     ${chalk.gray('Tags:')} ${tool.tags.map(t => chalk.magenta(t)).join(', ')}`);
+        }
+        if (matchReasons.length > 0) {
+            console.log(`     ${chalk.gray('Matched:')} ${matchReasons.join(', ')}`);
+        }
+        console.log();
+    }
+    if (result.servers.length > 0) {
+        console.log(chalk.bold('\n🖥️  Connected Servers:\n'));
+        for (const server of result.servers) {
+            const statusColor = server.health.status === 'healthy' ? 'green' : server.health.status === 'degraded' ? 'yellow' : 'red';
+            console.log(`  ${chalk[statusColor]('●')} ${chalk.white(server.name)} (${server.type})`);
+        }
+        console.log();
+    }
+    if (result.suggestions.length > 0) {
+        console.log(chalk.bold('\n💡 Suggestions:'));
+        for (const suggestion of result.suggestions) {
+            console.log(`   • ${suggestion}`);
+        }
+        console.log();
+    }
+}
+async function interactiveMode(registryUrl) {
+    console.log(chalk.bold('\n🎯 Nexus Discovery CLI - Interactive Mode\n'));
+    console.log(chalk.gray('Type your query or "exit" to quit\n'));
+    const { query } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'query',
+            message: 'What would you like to do?',
+            default: 'what can I do?',
+        },
+    ]);
+    if (query.toLowerCase() === 'exit') {
+        return;
+    }
+    const result = await discover(query, { registryUrl });
+    formatResults(result, false);
+    await interactiveMode(registryUrl);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+${chalk.bold('Nexus Discovery CLI')}
+
+${chalk.underline('Usage:')}
+  nexus-discover [query] [options]
+
+${chalk.underline('Options:')}
+  --url <url>      Registry URL (default: http://localhost:3000)
+  --limit <n>      Maximum tools to return (default: 20)
+  --json           Output as JSON
+  --interactive    Interactive mode
+  --help, -h       Show this help
+
+${chalk.underline('Examples:')}
+  nexus-discover "what can I do?"
+  nexus-discover "github repository" --limit 10
+  nexus-discover --json
+  nexus-discover --interactive
+    `);
+        return;
+    }
+    const interactive = args.includes('--interactive');
+    const json = args.includes('--json');
+    const urlArg = args.indexOf('--url');
+    const registryUrl = urlArg !== -1 ? args[urlArg + 1] : DEFAULT_REGISTRY_URL;
+    const limitArg = args.indexOf('--limit');
+    const limit = limitArg !== -1 ? parseInt(args[limitArg + 1], 10) : 20;
+    if (interactive) {
+        await interactiveMode(registryUrl);
+        return;
+    }
+    const query = args.filter(a => !a.startsWith('--')).join(' ') || 'what can I do?';
+    try {
+        const result = await discover(query, { registryUrl, limit, json });
+        formatResults(result, json);
+    }
+    catch {
+        process.exit(1);
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=discover.js.map

package/dist/cli/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../src/cli/discover.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAsCrD,KAAK,UAAU,OAAO,CAAI,GAAW,EAAE,OAAO,GAAG,KAAK;IACpD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAEhE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,YAAY,CAAC,SAAS,CAAC,CAAC;QAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,YAAY,CAAC,SAAS,CAAC,CAAC;QACxB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACrC,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,KAAa,EAAE,OAAiE;IACtG,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;IACxD,MAAM,OAAO,GAAG,GAAG,CAAC,gCAAgC,CAAC,CAAC,KAAK,EAAE,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9B,IAAI,OAAO,CAAC,KAAK;YAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAkB,GAAG,GAAG,oBAAoB,MAAM,EAAE,CAAC,CAAC;QAClF,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC9E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0CAA0C,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,CAAC,CAAC;gBAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAuB,EAAE,IAAa;IAC3D,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAElD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,YAAY,iBAAiB,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,WAAW,MAAM,MAAM,CAAC,aAAa,WAAW,CAAC,CAAC,CAAC;IAErG,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2DAA2D,CAAC,CAAC,CAAC;QACvF,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClE,MAAM,UAAU,GAAG,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;QAE7F,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzG,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAE7E,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACvD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;YAC1H,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAC7C,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,WAAmB;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC,CAAC;IACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAE/D,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACtC;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,4BAA4B;YACrC,OAAO,EAAE,gBAAgB;SAC1B;KACF,CAAC,CAAC;IAEH,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACtD,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE7B,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;AACrC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC;EACd,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC;;EAEjC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC;;;EAGzB,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC;;;;;;;EAO3B,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;;;;;KAKzB,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAErC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAE5E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtE,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,gBAAgB,CAAC;IAElF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import 'dotenv/config';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

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

package/dist/cli/index.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+import { RegistryServer } from '../registry/server.js';
+import 'dotenv/config';
+const config = {
+    port: parseInt(process.env.PORT || '3000', 10),
+    host: process.env.HOST || 'localhost',
+    jwtSecret: process.env.JWT_SECRET || 'dev-secret-change-in-production',
+    apiKey: process.env.API_KEY,
+    maxToolsPerResponse: parseInt(process.env.MAX_TOOLS_PER_RESPONSE || '50', 10),
+    contextTokenBudget: parseInt(process.env.CONTEXT_TOKEN_BUDGET || '128000', 10),
+    enableAuth: process.env.ENABLE_AUTH === 'true',
+};
+const server = new RegistryServer(config);
+process.on('SIGINT', async () => {
+    await server.stop();
+    process.exit(0);
+});
+process.on('SIGTERM', async () => {
+    await server.stop();
+    process.exit(0);
+});
+console.log(`
+╔══════════════════════════════════════════════════════════════╗
+║                         N E X U S                           ║
+║              MCP Tool Registry & Discovery Hub              ║
+╚══════════════════════════════════════════════════════════════╝
+`);
+server.start().catch((error) => {
+    console.error('Failed to start server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,eAAe,CAAC;AAEvB,MAAM,MAAM,GAAmB;IAC7B,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,EAAE,CAAC;IAC9C,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW;IACrC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,iCAAiC;IACtE,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;IAC3B,mBAAmB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,EAAE,EAAE,CAAC;IAC7E,kBAAkB,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,QAAQ,EAAE,EAAE,CAAC;IAC9E,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM;CAC/C,CAAC;AAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AAE1C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;IAC9B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;IAC/B,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC;;;;;CAKX,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC7B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/connectors/base.d.ts

@@ -0,0 +1,49 @@
+import type { MCPServer, Tool, ConnectorConfig } from '../types/index.js';
+export declare abstract class BaseConnector implements MCPServer {
+    abstract id: string;
+    abstract name: string;
+    abstract type: string;
+    protected config: ConnectorConfig;
+    protected connected: boolean;
+    tools: Tool[];
+    constructor(config: ConnectorConfig);
+    abstract connect(): Promise<void>;
+    abstract disconnect(): Promise<void>;
+    abstract healthCheck(): Promise<{
+        healthy: boolean;
+        latencyMs?: number;
+    }>;
+    abstract refreshTools(): Promise<Tool[]>;
+    getTools(): Tool[];
+    isConnected(): boolean;
+    protected createTool(partial: {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+        tags?: string[];
+        capabilities?: string[];
+        authRequirements?: {
+            required?: string[];
+            optional?: string[];
+        };
+        contextRequirements?: {
+            minTokens?: number;
+            maxTokens?: number;
+        };
+        metadata?: Record<string, unknown>;
+    }): Tool;
+    protected measureLatency<T>(fn: () => Promise<T>): Promise<{
+        result: T;
+        latencyMs: number;
+    }>;
+}
+export interface Connector {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        latencyMs?: number;
+    }>;
+    getTools(): Tool[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/connectors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/connectors/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E,8BAAsB,aAAc,YAAW,SAAS;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC;IAClC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAS;IACrC,KAAK,EAAE,IAAI,EAAE,CAAM;gBAEP,MAAM,EAAE,eAAe;IAInC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAExC,QAAQ,IAAI,IAAI,EAAE;IAIlB,WAAW,IAAI,OAAO;IAItB,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,gBAAgB,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;QAChE,mBAAmB,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,IAAI;cAyBQ,cAAc,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAMnG;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,IAAI,IAAI,EAAE,CAAC;CACpB"}

package/dist/connectors/base.js

@@ -0,0 +1,45 @@
+export class BaseConnector {
+    config;
+    connected = false;
+    tools = [];
+    constructor(config) {
+        this.config = config;
+    }
+    getTools() {
+        return this.tools;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    createTool(partial) {
+        const now = new Date().toISOString();
+        return {
+            id: `${this.id}:${partial.name}`,
+            serverId: this.id,
+            serverName: this.name,
+            createdAt: now,
+            updatedAt: now,
+            name: partial.name,
+            description: partial.description,
+            inputSchema: partial.inputSchema,
+            tags: partial.tags || [],
+            capabilities: partial.capabilities || [],
+            authRequirements: {
+                required: partial.authRequirements?.required || [],
+                optional: partial.authRequirements?.optional || [],
+            },
+            contextRequirements: {
+                minTokens: partial.contextRequirements?.minTokens || 0,
+                maxTokens: partial.contextRequirements?.maxTokens || 1000,
+            },
+            metadata: partial.metadata || {},
+        };
+    }
+    async measureLatency(fn) {
+        const start = performance.now();
+        const result = await fn();
+        const latencyMs = Math.round(performance.now() - start);
+        return { result, latencyMs };
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/connectors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/connectors/base.ts"],"names":[],"mappings":"AAEA,MAAM,OAAgB,aAAa;IAIvB,MAAM,CAAkB;IACxB,SAAS,GAAY,KAAK,CAAC;IACrC,KAAK,GAAW,EAAE,CAAC;IAEnB,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAOD,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAES,UAAU,CAAC,OASpB;QACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE;YAChC,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;YACxC,gBAAgB,EAAE;gBAChB,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE,QAAQ,IAAI,EAAE;gBAClD,QAAQ,EAAE,OAAO,CAAC,gBAAgB,EAAE,QAAQ,IAAI,EAAE;aACnD;YACD,mBAAmB,EAAE;gBACnB,SAAS,EAAE,OAAO,CAAC,mBAAmB,EAAE,SAAS,IAAI,CAAC;gBACtD,SAAS,EAAE,OAAO,CAAC,mBAAmB,EAAE,SAAS,IAAI,IAAI;aAC1D;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;SACjC,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,cAAc,CAAI,EAAoB;QACpD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QACxD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/connectors/custom.d.ts

@@ -0,0 +1,19 @@
+import { BaseConnector } from './base.js';
+import { ConnectorConfig, Tool, ToolDefinition } from '../types/index.js';
+export declare class CustomConnector extends BaseConnector {
+    id: string;
+    name: string;
+    type: string;
+    constructor(config: ConnectorConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        latencyMs?: number;
+    }>;
+    refreshTools(): Promise<Tool[]>;
+    registerCustomTool(definition: ToolDefinition): void;
+    unregisterCustomTool(name: string): boolean;
+    private buildTools;
+}
+//# sourceMappingURL=custom.d.ts.map

package/dist/connectors/custom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom.d.ts","sourceRoot":"","sources":["../../src/connectors/custom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA+F1E,qBAAa,eAAgB,SAAQ,aAAa;IAChD,EAAE,SAAY;IACd,IAAI,SAAkB;IACtB,IAAI,SAAY;gBAEJ,MAAM,EAAE,eAAe;IAK7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAIhE,YAAY,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAIrC,kBAAkB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAIpD,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAS3C,OAAO,CAAC,UAAU;CAGnB"}