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 分