@agenium/mcp-server 0.1.0

package/dist/cli.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+/**
+ * @agenium/mcp-server CLI
+ *
+ * Quick way to bridge an MCP server to the AGENIUM network.
+ *
+ * Usage:
+ *   npx @agenium/mcp-server --name weather-tools --command npx --args "-y @modelcontextprotocol/server-weather"
+ *   npx @agenium/mcp-server --name my-tools --sse http://localhost:3001/sse
+ */
+import { MCPBridge } from './bridge.js';
+function usage() {
+    console.log(`
+@agenium/mcp-server — Bridge MCP servers to the AGENIUM agent:// network
+
+Usage:
+  agenium-mcp [options]
+
+Options:
+  --name <name>         Agent name (required)
+  --command <cmd>       Stdio MCP server command
+  --args <args>         Command arguments (space-separated, quote if needed)
+  --cwd <dir>           Working directory for stdio server
+  --sse <url>           SSE endpoint URL (instead of stdio)
+  --host <ip>           Public host for DNS registration
+  --port <port>         Listen port (default: auto)
+  --dns <server>        DNS server (default: 185.204.169.26)
+  --no-register         Skip DNS registration
+  --log <level>         Log level: debug|info|warn|error|silent (default: info)
+  -h, --help            Show this help
+
+Examples:
+  # Bridge a weather MCP server
+  agenium-mcp --name weather --command npx --args "-y @modelcontextprotocol/server-weather" --host 1.2.3.4
+
+  # Bridge a running SSE server
+  agenium-mcp --name my-tools --sse http://localhost:3001/sse --host 1.2.3.4
+`);
+}
+function parseArgs(argv) {
+    const result = {};
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg === '-h' || arg === '--help') {
+            result['help'] = true;
+        }
+        else if (arg === '--no-register') {
+            result['noRegister'] = true;
+        }
+        else if (arg?.startsWith('--') && i + 1 < argv.length) {
+            result[arg.slice(2)] = argv[i + 1];
+            i++;
+        }
+        i++;
+    }
+    return result;
+}
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args['help'] || !args['name']) {
+        usage();
+        process.exit(args['help'] ? 0 : 1);
+    }
+    const name = args['name'];
+    // Determine MCP config
+    let mcp;
+    if (args['sse']) {
+        mcp = { transport: 'sse', url: args['sse'] };
+    }
+    else if (args['command']) {
+        mcp = {
+            transport: 'stdio',
+            command: args['command'],
+            args: args['args'] ? args['args'].split(/\s+/) : undefined,
+            cwd: args['cwd'],
+        };
+    }
+    else {
+        console.error('Error: Either --command or --sse is required');
+        usage();
+        process.exit(1);
+    }
+    const bridge = new MCPBridge({
+        name,
+        mcp,
+        agent: {
+            publicHost: args['host'],
+            port: args['port'] ? parseInt(args['port']) : undefined,
+            dnsServer: args['dns'],
+            autoRegister: !args['noRegister'],
+        },
+        bridge: {
+            logLevel: args['log'] ?? 'info',
+        },
+    });
+    // Handle graceful shutdown
+    const shutdown = async () => {
+        console.log('\nShutting down...');
+        await bridge.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    // Start
+    try {
+        await bridge.start();
+        const tools = bridge.getTools();
+        console.log(`\n✅ Bridge running as agent://${name}`);
+        console.log(`   Tools: ${tools.map((t) => t.name).join(', ') || 'none'}`);
+        console.log(`   Press Ctrl+C to stop\n`);
+    }
+    catch (err) {
+        console.error('Failed to start bridge:', err.message);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error('Fatal:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,SAAS,KAAK;IACZ,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;CAyBb,CAAC,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;QACxB,CAAC;aAAM,IAAI,GAAG,KAAK,eAAe,EAAE,CAAC;YACnC,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;QAC9B,CAAC;aAAM,IAAI,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACxD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACpC,CAAC,EAAE,CAAC;QACN,CAAC;QACD,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9C,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAW,CAAC;IAEpC,uBAAuB;IACvB,IAAI,GAAoB,CAAC;IACzB,IAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChB,GAAG,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAW,EAAE,CAAC;IACzD,CAAC;SAAM,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,GAAG,GAAG;YACJ,SAAS,EAAE,OAAO;YAClB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAW;YAClC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,MAAM,CAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YACtE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAuB;SACvC,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC9D,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI;QACJ,GAAG;QACH,KAAK,EAAE;YACL,UAAU,EAAE,IAAI,CAAC,MAAM,CAAuB;YAC9C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAuB;YAC5C,YAAY,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;SAClC;QACD,MAAM,EAAE;YACN,QAAQ,EAAG,IAAI,CAAC,KAAK,CAAS,IAAI,MAAM;SACzC;KACF,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,QAAQ;IACR,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QAErB,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/discovery.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @agenium/mcp-server — Discovery
+ *
+ * Discover MCP-bridged agents on the AGENIUM network and call their tools.
+ */
+import { MCPToolInfo, MCPResourceInfo, MCPPromptInfo } from './types.js';
+export interface MCPDiscoveryConfig {
+    /** DNS server address */
+    dnsServer?: string;
+    /** DNS server port */
+    dnsPort?: number;
+    /** Request timeout in ms */
+    timeoutMs?: number;
+}
+export interface DiscoveredMCPAgent {
+    /** Agent name */
+    name: string;
+    /** Agent URI */
+    uri: string;
+    /** Endpoint URL */
+    endpoint: string;
+    /** Available tools */
+    tools: MCPToolInfo[];
+    /** Available resources */
+    resources: MCPResourceInfo[];
+    /** Available prompts */
+    prompts: MCPPromptInfo[];
+    /** Raw capabilities list */
+    capabilities: string[];
+}
+export declare class MCPAgentClient {
+    private agent;
+    private config;
+    private started;
+    constructor(clientName: string, config?: MCPDiscoveryConfig);
+    /** Start the client agent */
+    start(): Promise<void>;
+    /** Stop the client agent */
+    stop(): Promise<void>;
+    /**
+     * Connect to an MCP-bridged agent and discover its capabilities
+     */
+    discover(agentUri: string): Promise<DiscoveredMCPAgent | null>;
+    /**
+     * Call a tool on a remote MCP-bridged agent
+     */
+    callTool(agentUri: string, toolName: string, args?: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text?: string;
+            data?: string;
+            mimeType?: string;
+        }>;
+        isError?: boolean;
+    }>;
+    /**
+     * Read a resource from a remote MCP-bridged agent
+     */
+    readResource(agentUri: string, resourceUri: string): Promise<{
+        contents: Array<{
+            uri: string;
+            text?: string;
+            blob?: string;
+            mimeType?: string;
+        }>;
+    }>;
+    /**
+     * Get a prompt from a remote MCP-bridged agent
+     */
+    getPrompt(agentUri: string, promptName: string, args?: Record<string, string>): Promise<{
+        description?: string;
+        messages: Array<{
+            role: string;
+            content: {
+                type: string;
+                text?: string;
+            };
+        }>;
+    }>;
+    private ensureStarted;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMzE,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD,MAAM,WAAW,kBAAkB;IACjC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,0BAA0B;IAC1B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,wBAAwB;IACxB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,kBAAkB;IAS3D,6BAA6B;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B,4BAA4B;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAkDpE;;OAEG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClF,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAuBF;;OAEG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,QAAQ,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnF,CAAC;IAmBF;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KAC7E,CAAC;IAuBF,OAAO,CAAC,aAAa;CAKtB"}

package/dist/discovery.js

@@ -0,0 +1,154 @@
+/**
+ * @agenium/mcp-server — Discovery
+ *
+ * Discover MCP-bridged agents on the AGENIUM network and call their tools.
+ */
+import { createAgent } from 'agenium';
+const DEFAULTS = {
+    dnsServer: '185.204.169.26',
+    dnsPort: 3000,
+    timeoutMs: 15_000,
+};
+// ============================================================================
+// MCP Client (for calling remote MCP-bridged agents)
+// ============================================================================
+export class MCPAgentClient {
+    agent;
+    config;
+    started = false;
+    constructor(clientName, config) {
+        this.config = { ...DEFAULTS, ...config };
+        this.agent = createAgent(clientName, {
+            dnsServer: this.config.dnsServer,
+            listenPort: 0,
+            persistence: false,
+        });
+    }
+    /** Start the client agent */
+    async start() {
+        if (this.started)
+            return;
+        await this.agent.start();
+        this.started = true;
+    }
+    /** Stop the client agent */
+    async stop() {
+        if (!this.started)
+            return;
+        await this.agent.stop();
+        this.started = false;
+    }
+    /**
+     * Connect to an MCP-bridged agent and discover its capabilities
+     */
+    async discover(agentUri) {
+        this.ensureStarted();
+        const result = await this.agent.connect(agentUri);
+        if (!result.success || !result.session) {
+            return null;
+        }
+        const sessionId = result.session.id;
+        try {
+            // Get capabilities
+            const caps = await this.agent.request(sessionId, 'capabilities');
+            // Get tools
+            const toolsResult = await this.agent.request(sessionId, 'tools/list');
+            const tools = toolsResult?.tools ?? [];
+            // Get resources
+            let resources = [];
+            try {
+                const resourcesResult = await this.agent.request(sessionId, 'resources/list');
+                resources = resourcesResult?.resources ?? [];
+            }
+            catch {
+                // May not support resources
+            }
+            // Get prompts
+            let prompts = [];
+            try {
+                const promptsResult = await this.agent.request(sessionId, 'prompts/list');
+                prompts = promptsResult?.prompts ?? [];
+            }
+            catch {
+                // May not support prompts
+            }
+            return {
+                name: caps?.agent ?? agentUri.replace('agent://', ''),
+                uri: agentUri,
+                endpoint: '',
+                tools,
+                resources,
+                prompts,
+                capabilities: caps?.tools ?? [],
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Call a tool on a remote MCP-bridged agent
+     */
+    async callTool(agentUri, toolName, args) {
+        this.ensureStarted();
+        const result = await this.agent.connect(agentUri);
+        if (!result.success || !result.session) {
+            throw new Error(`Failed to connect to ${agentUri}: ${result.error}`);
+        }
+        const response = await this.agent.request(result.session.id, 'tools/call', {
+            name: toolName,
+            arguments: args,
+        });
+        if (response?.error) {
+            throw new Error(`Tool call failed: ${response.error.message}`);
+        }
+        return {
+            content: response?.content ?? [],
+            isError: response?.isError,
+        };
+    }
+    /**
+     * Read a resource from a remote MCP-bridged agent
+     */
+    async readResource(agentUri, resourceUri) {
+        this.ensureStarted();
+        const result = await this.agent.connect(agentUri);
+        if (!result.success || !result.session) {
+            throw new Error(`Failed to connect to ${agentUri}: ${result.error}`);
+        }
+        const response = await this.agent.request(result.session.id, 'resources/read', {
+            uri: resourceUri,
+        });
+        if (response?.error) {
+            throw new Error(`Resource read failed: ${response.error.message}`);
+        }
+        return { contents: response?.contents ?? [] };
+    }
+    /**
+     * Get a prompt from a remote MCP-bridged agent
+     */
+    async getPrompt(agentUri, promptName, args) {
+        this.ensureStarted();
+        const result = await this.agent.connect(agentUri);
+        if (!result.success || !result.session) {
+            throw new Error(`Failed to connect to ${agentUri}: ${result.error}`);
+        }
+        const response = await this.agent.request(result.session.id, 'prompts/get', {
+            name: promptName,
+            arguments: args,
+        });
+        if (response?.error) {
+            throw new Error(`Prompt get failed: ${response.error.message}`);
+        }
+        return {
+            description: response?.description,
+            messages: response?.messages ?? [],
+        };
+    }
+    ensureStarted() {
+        if (!this.started) {
+            throw new Error('MCPAgentClient not started. Call start() first.');
+        }
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @agenium/mcp-server
+ *
+ * Bridge MCP (Model Context Protocol) servers to the AGENIUM agent:// network.
+ *
+ * Usage:
+ * ```typescript
+ * import { MCPBridge } from '@agenium/mcp-server';
+ *
+ * const bridge = new MCPBridge({
+ *   name: 'weather-tools',
+ *   mcp: {
+ *     transport: 'stdio',
+ *     command: 'npx',
+ *     args: ['-y', '@modelcontextprotocol/server-weather'],
+ *   },
+ *   agent: {
+ *     publicHost: '203.0.113.1',
+ *   },
+ * });
+ *
+ * await bridge.start();
+ * // Now registered as agent://weather-tools on the AGENIUM network
+ * ```
+ */
+export { MCPBridge } from './bridge.js';
+export { MCPAgentClient, type DiscoveredMCPAgent, type MCPDiscoveryConfig } from './discovery.js';
+export { MCPTransportManager } from './mcp-transport.js';
+export { type MCPBridgeConfig, type MCPStdioConfig, type MCPHttpConfig, type MCPStreamableHttpConfig, type MCPServerConfig, type MCPToolInfo, type MCPResourceInfo, type MCPPromptInfo, BridgeState, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGlG,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @agenium/mcp-server
+ *
+ * Bridge MCP (Model Context Protocol) servers to the AGENIUM agent:// network.
+ *
+ * Usage:
+ * ```typescript
+ * import { MCPBridge } from '@agenium/mcp-server';
+ *
+ * const bridge = new MCPBridge({
+ *   name: 'weather-tools',
+ *   mcp: {
+ *     transport: 'stdio',
+ *     command: 'npx',
+ *     args: ['-y', '@modelcontextprotocol/server-weather'],
+ *   },
+ *   agent: {
+ *     publicHost: '203.0.113.1',
+ *   },
+ * });
+ *
+ * await bridge.start();
+ * // Now registered as agent://weather-tools on the AGENIUM network
+ * ```
+ */
+// Main bridge
+export { MCPBridge } from './bridge.js';
+// Discovery client
+export { MCPAgentClient } from './discovery.js';
+// Transport manager (for advanced use)
+export { MCPTransportManager } from './mcp-transport.js';
+// Types
+export { BridgeState, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAoD,MAAM,gBAAgB,CAAC;AAElG,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,QAAQ;AACR,OAAO,EASL,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/mcp-transport.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @agenium/mcp-server — MCP Transport Manager
+ *
+ * Manages the connection to an MCP server (stdio, SSE, or streamable HTTP).
+ * Provides a unified interface for listing tools, calling tools, etc.
+ */
+import { MCPServerConfig, MCPToolInfo, MCPResourceInfo, MCPPromptInfo } from './types.js';
+export declare class MCPTransportManager {
+    private client;
+    private transport;
+    private config;
+    private connected;
+    constructor(config: MCPServerConfig);
+    /** Connect to the MCP server */
+    connect(): Promise<void>;
+    /** Disconnect from the MCP server */
+    disconnect(): Promise<void>;
+    /** Check if connected */
+    isConnected(): boolean;
+    /** List all tools exposed by the MCP server */
+    listTools(): Promise<MCPToolInfo[]>;
+    /** Call a tool on the MCP server */
+    callTool(name: string, args?: Record<string, unknown>): Promise<{
+        content: Array<{
+            type: string;
+            text?: string;
+            data?: string;
+            mimeType?: string;
+        }>;
+        isError?: boolean;
+    }>;
+    /** List all resources */
+    listResources(): Promise<MCPResourceInfo[]>;
+    /** Read a resource */
+    readResource(uri: string): Promise<{
+        contents: Array<{
+            uri: string;
+            text?: string;
+            blob?: string;
+            mimeType?: string;
+        }>;
+    }>;
+    /** List all prompts */
+    listPrompts(): Promise<MCPPromptInfo[]>;
+    /** Get a prompt */
+    getPrompt(name: string, args?: Record<string, string>): Promise<{
+        description?: string;
+        messages: Array<{
+            role: string;
+            content: {
+                type: string;
+                text?: string;
+            };
+        }>;
+    }>;
+    /** Get MCP server info (if available after connect) */
+    getServerInfo(): {
+        name?: string;
+        version?: string;
+    } | null;
+    private ensureConnected;
+}
+//# sourceMappingURL=mcp-transport.d.ts.map

package/dist/mcp-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-transport.d.ts","sourceRoot":"","sources":["../src/mcp-transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EACL,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAMpB,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAA0D;IAC3E,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,eAAe;IAQnC,gCAAgC;IAC1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C9B,qCAAqC;IAC/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC,yBAAyB;IACzB,WAAW,IAAI,OAAO;IAQtB,+CAA+C;IACzC,SAAS,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAUzC,oCAAoC;IAC9B,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAClF,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAaF,yBAAyB;IACnB,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAgBjD,sBAAsB;IAChB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACvC,QAAQ,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnF,CAAC;IAYF,uBAAuB;IACjB,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAmB7C,mBAAmB;IACb,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KAC7E,CAAC;IAaF,uDAAuD;IACvD,aAAa,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAU3D,OAAO,CAAC,eAAe;CAKxB"}