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

Slack动图

by anthropics

Universal
热门

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

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

平台与服务
未扫描165.3k

MCP构建

by anthropics

Universal
热门

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

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

平台与服务
未扫描165.3k

接口测试套件

by alirezarezvani

Universal
热门

扫描 Next.js、Express、FastAPI、Django REST 的 API 路由,自动生成覆盖鉴权、参数校验、错误码、分页、上传与限流场景的 Vitest 或 Pytest 测试套件。

帮你把API与集成测试自动化跑顺,减少回归漏测;能力全面,尤其适合复杂接口场景的QA团队。

平台与服务
未扫描23.5k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

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

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

平台与服务
89.1k

by netdata

热门

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

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

平台与服务
79.9k

by d4vinci

热门

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

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

平台与服务
71.9k

评论