io.github.Aganium/mcp-server
平台与服务by aganium
通过 DNS discovery 将 MCP servers 桥接到 AGENIUM agent:// 网络,便于服务发现与接入。
什么是 io.github.Aganium/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)
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
npm install agenium
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
- Visit marketplace.agenium.net
- Register a domain name (e.g.,
agent://myagent) - Complete purchase (TON payment)
- Save your API key (shown only once)
CLI
# Initialize agent configuration
agenium init
# Resolve an agent
agenium resolve agent://search
# Check connection
agenium status
# End-to-end connectivity test
agenium e2e
Architecture
agent://myagent agent://search
│ │
├── resolve("agent://search") ────►│
│ (DNS lookup via marketplace) │
│◄── endpoint: https://... ───────┤
│ │
├── POST /a2a/message ────────────►│
│ (HTTP/2 + mTLS) │
│◄── response ────────────────────┤
Configuration
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:
| Service | URI | Description |
|---|---|---|
| Search | agent://agenium | Agent & tool discovery engine |
| Marketplace | marketplace.agenium.net | Domain registration & credentials |
Development
# 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
| Package | Description |
|---|---|
agenium | Core client SDK |
@agenium/create-agent | CLI scaffold tool |
@agenium/mcp-server | MCP → agent:// bridge |
discord-agenium | Discord bot gateway |
slack-agenium | Slack app gateway |
n8n-nodes-agenium | n8n automation nodes |
Links
- Website: agenium.net
- Docs: docs.agenium.net
- Demo: demo.agenium.net
- Marketplace: marketplace.agenium.net
- Organization: github.com/Aganium
常见问题
io.github.Aganium/mcp-server 是什么?
通过 DNS discovery 将 MCP servers 桥接到 AGENIUM agent:// 网络,便于服务发现与接入。
相关 Skills
MCP构建
by anthropics
聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。
✎ 想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。
Slack动图
by anthropics
面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。
✎ 帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。
MCP服务构建器
by alirezarezvani
从 OpenAPI 一键生成 Python/TypeScript MCP server 脚手架,并校验 tool schema、命名规范与版本兼容性,适合把现有 REST API 快速发布成可生产演进的 MCP 服务。
✎ 帮你快速搭建 MCP 服务与后端 API,脚手架完善、扩展顺手,尤其适合想高效验证服务能力的开发者。
相关 MCP Server
Slack 消息
编辑精选by Anthropic
Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。
✎ 这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。
by netdata
io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。
✎ 这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。
by d4vinci
Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。
✎ 这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。