Agenium Mcp Server

io.github.chorghemaruti64-creator由 GitHub 帳號 chorghemaruti64-creator 發布v0.1.3更新於 Oct 24, 2026

Bridge MCP servers to the AGENIUM agent:// network via DNS discovery

已驗證STDIO僅桌面雲端與基礎設施開發者工具

概覽

AI 產生的概覽

一個本機 npm 函式庫，把 MCP 伺服器橋接到 AGENIUM agent:// 網路，並在 AGENIUM DNS 上註冊，讓其他代理能探索並呼叫其 MCP 工具。

可以做什麼
將 MCP 伺服器暴露為 AGENIUM 代理：啟動 stdio MCP 伺服器或連線 SSE、streamable-HTTP 伺服器，再以 agent:// 名稱註冊到 AGENIUM DNS，並列出其工具、資源與提示。呼叫遠端橋接代理上的工具：探索代理的工具並以參數呼叫指定工具。提供 agent:// 協定方法，用於列出與呼叫工具、讀取資源、取得提示、能力清單與健康檢查。發出橋接事件，涵蓋就緒、註冊、工具呼叫、結果、錯誤與停止。
適用情境
當你想把現有 MCP 伺服器發布為 AGENIUM 網路上可探索、可呼叫的代理，或當代理需要探索並呼叫遠端 AGENIUM 橋接 MCP 伺服器上的工具時使用。
執行需求
需要 Node.js 與 npm 套件 @agenium/mcp-server，以本機程序執行。需要一個待橋接的 MCP 伺服器（stdio 指令、SSE 位址或 streamable-HTTP 位址）。需要連線 AGENIUM DNS 的網路，預設使用公開解析器，可用 AGENIUM_DNS_URL 或 dnsServer 選項覆寫。註冊時需要公開主機或 IP。
安裝前請注意
橋接會把伺服器註冊到公開 DNS 解析器，並向其他 AGENIUM 代理暴露其工具、資源與提示，因此透過被橋接 MCP 伺服器可存取的內容都會變成可遠端呼叫。遠端工具呼叫可能操作你的資料。預設 DNS 解析器是第三方位址，如有需要可將 AGENIUM_DNS_URL 指向你信任的解析器。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Agenium Mcp Server，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@agenium/mcp-server

Bridge MCP (Model Context Protocol) servers to the AGENIUM agent:// network.

Any MCP server → discoverable, callable agent on the AGENIUM network.

Install

bash
npm install @agenium/mcp-server

Quick Start

Expose an MCP server as an AGENIUM agent

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', // Your server's public IP  },});
await bridge.start();// ✅ MCP server connected// ✅ Found 2 tools: get_forecast, get_alerts// ✅ AGENIUM agent "weather-tools" started// ✅ Registered on AGENIUM DNS as agent://weather-tools
console.log(bridge.getTools());// [{ name: 'get_forecast', description: '...', inputSchema: {...} }, ...]

Call tools on a remote MCP-bridged agent

typescript
import { MCPAgentClient } from '@agenium/mcp-server';
const client = new MCPAgentClient('my-agent');await client.start();
// Discover what tools an agent hasconst info = await client.discover('agent://weather-tools');console.log(info.tools);
// Call a toolconst result = await client.callTool('agent://weather-tools', 'get_forecast', {  city: 'Tehran',  days: 3,});console.log(result.content);
await client.stop();

Configuration

MCPBridgeConfig

typescript
{  // Agent name on the AGENIUM network  name: string;
  // MCP server configuration  mcp: {    // stdio: spawn a child process    transport: 'stdio';    command: string;    args?: string[];    cwd?: string;    env?: Record<string, string>;  } | {    // SSE: connect to running server    transport: 'sse';    url: string;    headers?: Record<string, string>;  } | {    // Streamable HTTP (MCP v2)    transport: 'streamable-http';    url: string;    headers?: Record<string, string>;  };
  // AGENIUM agent options  agent?: {    port?: number;           // Listen port (default: auto)    dnsServer?: string;      // DNS server (default: 185.204.169.26)    dnsPort?: number;        // DNS port (default: 3000)    autoRegister?: boolean;  // Register on DNS (default: true)    publicHost?: string;     // Public IP for registration    dataDir?: string;        // State directory  };
  // Bridge behavior  bridge?: {    toolCallTimeoutMs?: number;  // Tool call timeout (default: 30s)    exposeResources?: boolean;   // Expose MCP resources (default: true)    exposePrompts?: boolean;     // Expose MCP prompts (default: true)    logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'silent';  };}

Protocol

When an MCP server is bridged, it exposes these agent:// request methods:

MethodDescriptionParams
tools/listList available tools—
tools/callCall a tool{ name, arguments? }
resources/listList available resources—
resources/readRead a resource{ uri }
prompts/listList available prompts—
prompts/getGet a prompt{ name, arguments? }
capabilitiesGet full capability manifest—
pingHealth check—

Events

typescript
bridge.on('ready', ({ tools, resources, prompts }) => { ... });bridge.on('registered', ({ name, endpoint }) => { ... });bridge.on('tool:call', ({ tool, sessionId }) => { ... });bridge.on('tool:result', ({ tool, sessionId, durationMs }) => { ... });bridge.on('tool:error', ({ tool, sessionId, error }) => { ... });bridge.on('error', (err) => { ... });bridge.on('stopped', () => { ... });

How It Works

┌─────────────┐     agent://      ┌──────────────┐     JSON-RPC      ┌────────────┐│ Agent Client │ ──────────────▶  │  MCP Bridge   │ ──────────────▶  │ MCP Server ││              │                  │  (@agenium/   │                  │ (any tool) ││ Any AGENIUM  │  ◀──────────────  │  mcp-server)  │  ◀──────────────  │            ││ agent        │     response     │               │    tool result   │            │└─────────────┘                  └──────────────┘                  └────────────┘                                       │                                       │ registers                                       ▼                                 ┌──────────────┐                                 │ AGENIUM DNS  │                                 │ 185.204.169.26│                                 └──────────────┘

Python SDK

A Python version (agenium-mcp-server) is planned. For now, use the npm package.

License

MIT

來源：packages/mcp-bridge/README.md，提交 9103e1a

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分