agenium-mcp-server

@agenium/mcp-server

MCP（Model Context Protocol）サーバーを、AGENIUM の agent:// ネットワークに接続します。

あらゆる MCP サーバーを、AGENIUM ネットワーク上で検出・呼び出し可能なエージェントにします。

インストール

npm install @agenium/mcp-server

クイックスタート

MCP サーバーを AGENIUM エージェントとして公開する

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: {...} }, ...]

リモートの MCP ブリッジ接続エージェント上のツールを呼び出す

import { MCPAgentClient } from '@agenium/mcp-server';

const client = new MCPAgentClient('my-agent');
await client.start();

// Discover what tools an agent has
const info = await client.discover('agent://weather-tools');
console.log(info.tools);

// Call a tool
const result = await client.callTool('agent://weather-tools', 'get_forecast', {
  city: 'Tehran',
  days: 3,
});
console.log(result.content);

await client.stop();

設定

MCPBridgeConfig

{
  // 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';
  };
}

プロトコル

MCP サーバーをブリッジ接続すると、次の agent:// リクエストメソッドが公開されます。

メソッド	説明	パラメーター
tools/list	利用可能なツールを一覧表示します	—
tools/call	ツールを呼び出します	{ name, arguments? }
resources/list	利用可能なリソースを一覧表示します	—
resources/read	リソースを読み取ります	{ uri }
prompts/list	利用可能なプロンプトを一覧表示します	—
prompts/get	プロンプトを取得します	{ name, arguments? }
capabilities	完全な機能マニフェストを取得します	—
ping	ヘルスチェック	—

イベント

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', () => { ... });

仕組み

┌─────────────┐     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

Python 版（agenium-mcp-server）は開発予定です。現時点では npm パッケージを使用してください。

ライセンス

MIT