Hive Log

hive-mcp-log

入站结构化日志采集垫片 — Hive Civilization

通过 x402 采集 NDJSON 日志，每行 $0.0001。保留期限（1d 免费、7d $0.005/MB、30d $0.02/MB）。提供尾随和搜索端点。纯协议 — 仅入站，不发起出站调用。

委员会溯源：A 级入站计量垫片。与 hive-mcp-auction 和 hive-mcp-barter 配套。

---

这是什么

hive-mcp-log 是一个 Model Context Protocol 服务，为自主 Agent 提供按量计费的日志采集接口。Agent 通过 POST 发送结构化日志（NDJSON），并在 Base L2 上以 USDC 支付每行 $0.0001。它们可在 Tier 0（免费）通过尾随和搜索读取自己的日志。保留等级决定日志行的保存时长；默认的 1 天等级免费，更长的保留期限则按 MB 收取附加费。

• 协议： MCP 2024-11-05，基于 Streamable-HTTP / JSON-RPC 2.0
• 传输： POST /mcp
• 发现： GET /.well-known/mcp.json
• 健康检查： GET /health
• 结算： Base L2 上的 USDC — 使用真实支付通道，无模拟，无仿真
• 品牌金色： Pantone 1245 C / #C08D23
• 仅入站： 服务不会主动联系、发送私信或拉取数据

MCP 工具

工具	等级	描述
log_ingest	按量计费	采集 NDJSON 批次（最多 4 MB / 10k 行）。每行 $0.0001 + 保留期限附加费。
log_tail	0（免费）	返回调用方 DID 的最后 N 行日志。
log_search	0（免费）	按时间、严重性、标签或自由文本搜索自己的 DID 日志。
log_retention_get	0（免费）	返回当前等级 + 已存储字节数。
log_retention_set	0（免费）	更改保留等级（1d/7d/30d）。
log_today	0（免费）	今日汇总 — 采集次数、行数、字节数、charge_usd。

REST 端点

方法	路径	用途
POST	/v1/log/ingest	采集 NDJSON 批次。首先返回 402 信封，接受 tx_hash 进行结算。
GET	/v1/log/tail	返回 did 的最后 N 行。
GET	/v1/log/search	按时间、严重性、标签或 q 搜索。使用游标分页。
GET	/v1/log/retention	返回当前保留等级 + 月度费用预估。
PATCH	/v1/log/retention	更改某个 DID 的保留等级。
GET	/v1/log/today	今日汇总（Tier 0，免费）。
POST	/mcp	MCP JSON-RPC 2.0 接口。
GET	/health	服务健康状态。

定价

Ingest:    $0.0001 per log line
Retention:
  1d   (default)   free
  7d               $0.005 / MB
  30d              $0.02  / MB
Tail / search (own-DID):  Tier 0 — free

NDJSON 采集示例

curl -X POST https://hive-mcp-log.onrender.com/v1/log/ingest \
  -H 'content-type: application/json' \
  -H 'x-hive-did: did:hive:agent-foo' \
  -d '{
    "did": "did:hive:agent-foo",
    "retention_class": "7d",
    "lines": [
      { "ts": "2026-04-27T20:00:00Z", "severity": "info",  "tag": "tool", "msg": "tool_call ok" },
      { "ts": "2026-04-27T20:00:01Z", "severity": "error", "tag": "llm",  "msg": "rate_limited" }
    ]
  }'

首次调用会返回包含支付信封的 402（Base L2 USDC）。完成结算后，使用 x-hive-tx: <hash> 重新发送请求，以进行同步验证。

尾随 / 搜索示例

curl 'https://hive-mcp-log.onrender.com/v1/log/tail?did=did:hive:agent-foo&n=20'
curl 'https://hive-mcp-log.onrender.com/v1/log/search?did=did:hive:agent-foo&severity=error&q=rate'

保留期限

curl -X PATCH https://hive-mcp-log.onrender.com/v1/log/retention \
  -H 'content-type: application/json' \
  -d '{ "did": "did:hive:agent-foo", "tier": "7d" }'

定期清理任务（默认每小时运行）会删除超出各 DID 保留期限的日志行。

环境变量

变量	默认值	说明
PORT	3000
ENABLE	true	设为 false 可禁用日志采集（返回带有 log_ingestion_disabled 的 503）。
WALLET_ADDRESS	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e	Base L2 上的 W1 MONROE。
SOLANA_WALLET	B1N61cuL35fhskWz5dw8XqDyP6LWi3ZWmq8CNA9L3FVn	B1 SPL 接收方。
USDC_BASE	canonical	Base 上的 USDC 合约。
BASE_RPC	https://mainnet.base.org
PUBLIC_BASE_URL	https://hive-mcp-log.onrender.com
MAX_LINES_PER_INGEST	10000
MAX_BYTES_PER_INGEST	4194304	4 MB。
RETENTION_SWEEP_MS	3600000	1 小时。

安全与范围

• v1 不开放跨 DID 读取（尾随 / 搜索仅限自己的 DID）。
• v1 不检测 PII；默认由客户端自行遵守相关规范。架构检查是 v1.1 的候选功能。
• ZK 基数证明由独立的垫片 hive-mcp-zk-attestation 提供，不包含在内。

许可证

MIT — Steve Rotzin / Hive Civilization

Hive Gamification

此 MCP 服务属于 Hive Civilization 的游戏化功能界面（10 种机制的能力分类）。

• 能力分类：https://hive-gamification.onrender.com/.well-known/hive-gamification.json
• Centrifuge 仪表板：https://hive-gamification.onrender.com/.well-known/hive-centrifuge.json
• 汇总 OpenAPI：https://hive-gamification.onrender.com/.well-known/openapi.json

功能界面标签： gamification.spec.v1 · gamification.surface.public · gamification.signal.read-only · gamification.settlement.real-rails

Base L2 上的真实轨道（USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）。只读信号层。品牌金色 #C08D23。

Hive Civilization 目录

Hive Civilization 的一部分——面向 Agent 的金融基础设施。

• 端点目录：https://thehiveryiq.com
• 实时排行榜：https://hive-a2amev.onrender.com/leaderboard
• 收入仪表板：https://hivemine-dashboard.onrender.com
• 其他 MCP 服务：https://github.com/srotzin?tab=repositories&q=hive-mcp

品牌色：#C08D23