io.github.chorghemaruti64-creator/agenium-mcp-server

平台与服务

by aganium

通过 DNS discovery 将 MCP servers 桥接到 AGENIUM 的 agent:// 网络,实现自动发现与接入。

什么是 io.github.chorghemaruti64-creator/agenium-mcp-server

通过 DNS discovery 将 MCP servers 桥接到 AGENIUM 的 agent:// 网络,实现自动发现与接入。

README

AGENIUM

Stateful agent-to-agent communication client for the agent:// protocol.

What is AGENIUM?

AGENIUM provides identity, discovery, and messaging for AI agents. Think of it as DNS + HTTP for agents — each agent gets a unique agent://name URI and can discover and communicate with other agents.

Quick Start

Create a New Agent (Recommended)

bash
npx @agenium/create-agent my-agent
cd my-agent
npm install
npm start

Choose from 3 templates: echo (hello world), tools (tool-calling), api (REST gateway).

Use as a Library

bash
npm install agenium
typescript
import { AgeniumClient } from 'agenium';

const client = new AgeniumClient({
  apiKey: 'dom_your_api_key_here',  // Get one at marketplace.agenium.net
  agentUri: 'agent://myagent',
});

// Resolve another agent
const target = await client.resolve('agent://search');
console.log(target.endpoint); // https://...

// Connect and send message
const session = await client.connect('agent://search');
await session.send({ query: 'find MCP servers for GitHub' });
const response = await session.receive();

Features

  • agent:// Protocol — Unique agent identity via URI scheme
  • DNS Resolution — Discover agents by name (agent://name → endpoint)
  • Stateful Sessions — SQLite-backed persistent sessions
  • HTTP/2 + mTLS — Secure transport with mutual TLS
  • At-Least-Once Delivery — Outbox pattern for reliable messaging
  • Circuit Breakers — Automatic failure detection and recovery
  • Prometheus Metrics — Built-in observability

Getting an API Key

  1. Visit marketplace.agenium.net
  2. Register a domain name (e.g., agent://myagent)
  3. Complete purchase (TON payment)
  4. Save your API key (shown only once)

CLI

bash
# Initialize agent configuration
agenium init

# Resolve an agent
agenium resolve agent://search

# Check connection
agenium status

# End-to-end connectivity test
agenium e2e

Architecture

code
agent://myagent                    agent://search
     │                                  │
     ├── resolve("agent://search") ────►│
     │   (DNS lookup via marketplace)   │
     │◄── endpoint: https://...  ───────┤
     │                                  │
     ├── POST /a2a/message ────────────►│
     │   (HTTP/2 + mTLS)               │
     │◄── response ────────────────────┤

Configuration

typescript
const client = new AgeniumClient({
  // Required
  apiKey: 'dom_xxx',           // Your marketplace API key
  agentUri: 'agent://myname',  // Your agent URI

  // Optional
  dnsServer: 'https://marketplace.agenium.net',  // DNS resolver
  dataDir: './data',           // SQLite session storage
  timeout: 30000,              // Request timeout (ms)
  retries: 3,                  // Max retry attempts
});

API Reference

client.resolve(agentUri)

Resolve an agent URI to its endpoint and capabilities.

client.connect(agentUri)

Establish a stateful session with another agent.

session.send(message)

Send a message in an active session.

session.receive()

Receive the next message in a session.

session.close()

Gracefully close a session.

Protocol Services

The AGENIUM ecosystem includes:

ServiceURIDescription
Searchagent://ageniumAgent & tool discovery engine
Marketplacemarketplace.agenium.netDomain registration & credentials

Development

bash
# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Run E2E tests
npm run e2e

Tests

56 tests passing:

  • 22 unit tests
  • 24 bug-server integration tests
  • 10 end-to-end tests

License

MIT

Ecosystem

PackageDescription
ageniumCore client SDK
@agenium/create-agentCLI scaffold tool
@agenium/mcp-serverMCP → agent:// bridge
discord-ageniumDiscord bot gateway
slack-ageniumSlack app gateway
n8n-nodes-ageniumn8n automation nodes

Links

常见问题

io.github.chorghemaruti64-creator/agenium-mcp-server 是什么?

通过 DNS discovery 将 MCP servers 桥接到 AGENIUM 的 agent:// 网络,实现自动发现与接入。

相关 Skills

MCP构建

by anthropics

Universal
热门

聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。

想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。

平台与服务
未扫描114.1k

Slack动图

by anthropics

Universal
热门

面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。

帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。

平台与服务
未扫描114.1k

MCP服务构建器

by alirezarezvani

Universal
热门

从 OpenAPI 一键生成 Python/TypeScript MCP server 脚手架,并校验 tool schema、命名规范与版本兼容性,适合把现有 REST API 快速发布成可生产演进的 MCP 服务。

帮你快速搭建 MCP 服务与后端 API,脚手架完善、扩展顺手,尤其适合想高效验证服务能力的开发者。

平台与服务
未扫描10.2k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。

这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。

平台与服务
83.4k

by netdata

热门

io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。

这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。

平台与服务
78.4k

by d4vinci

热门

Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。

这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。

平台与服务
35.4k

评论