acmi-mcp

ACMI - Agentic Context Memory Interface

AI Agent 集群的协调骨干。三个 Redis 键——Profile、Signals、Timeline。

ACMI 是用于持久化 Agent 上下文的开放协议。v1.5 版本正式确立了集群通信协议：原子化的前置/后置事件、唤醒指令、交接确认链，以及支持关联追踪的时间线，让多 Agent 协作可审计，而不只是道听途说。

每个实体都恰好存储大模型做出决策所需的三项内容：

Profile  -> who   (identity, preferences, stable facts)
Signals  -> now   (current state, blockers, next action)
Timeline -> then  (append-only event log from every source)

其结构刻意保持精简：

• Profile：稳定的身份与配置。
• Signals：可变状态与合成的工作记忆。
• Timeline：按时间排序的不可变历史记录。

此仓库提供公开的 ACMI 包、MCP 服务子包，以及确保集群保持步调一致的文档：

• @madezmedia/acmi - TypeScript SDK、命令行工具和一致性测试套件。
• mcp/ - @madezmedia/acmi-mcp，供需要直接访问 ACMI 的宿主使用的 MCP 服务。
• SPEC.md - 规范协议说明。
• CHANGELOG.md - 版本历史，包括 v1.5.0 集群通信更新。
• docs/ - 运维指南、速查表和协议说明。

v1.5 新增内容

v1.5.0 版本通过共享的事件语言，让集群保持一致：

• 原子化提交前置/后置事件
• 圆桌协调与唤醒指令
• source、kind、correlationId、summary 事件封装规范
• 执行操作前检查信号的新鲜度
• 在整个集群中使用 agent:<id> 作为来源名称

安装

npm install @madezmedia/acmi

快速开始

import { createAcmi } from "@madezmedia/acmi";
import { InMemoryAdapter } from "@madezmedia/acmi/adapters/in-memory";

const acmi = createAcmi(new InMemoryAdapter());

await acmi.profile.set("user:mikey", {
  name: "Michael Shaw",
  role: "operator",
  location: "Charlotte, NC, USA",
});

await acmi.signals.set("user:mikey", "current_focus", "ACMI v1.5 fleet sync");

await acmi.timeline.append("user:mikey", {
  ts: Date.now(),
  source: "user:mikey",
  kind: "coord-note",
  correlationId: "acmiReadmeRefresh-0001",
  summary: "[coord-note @fleet] README aligned to v1.5 and local assets.",
});

生产适配器

import { createAcmi } from "@madezmedia/acmi";
import { UpstashAdapter } from "@madezmedia/acmi/adapters/upstash";

const acmi = createAcmi(
  new UpstashAdapter({
    url: process.env.UPSTASH_REDIS_REST_URL!,
    token: process.env.UPSTASH_REDIS_REST_TOKEN!,
  })
);

适配器	用例	兼容边缘环境
@madezmedia/acmi/adapters/in-memory	测试、示例、本地开发	不适用
@madezmedia/acmi/adapters/upstash	Vercel、Workers、边缘运行时	是
@madezmedia/acmi/adapters/redis	自托管 Redis / Node	否

集群协议

ACMI v1.5 使用共享事件格式，以便追踪每个重要操作：

{
  "ts": 1780000000000,
  "source": "agent:codex",
  "kind": "handoff-ack",
  "correlationId": "codexGrantDraft-1780000000000",
  "summary": "[handoff-ack @ops-center] Draft ready for review."
}

实践中需要遵守的规则：

• 在摘要中使用 [kind-tag @recipient]
• 确保 source 以 agent:、user: 或 system: 为前缀
• 使用 parentCorrelationId 关联后续事件
• 保持时间线只追加，不修改
• 工作流依赖当前状态时，执行操作前先验证信号

相关页面

• ACMI 产品 / 在线演示
• ACMI 运维界面
• ACMI MCP 服务 README
• 运维指南
• ACMI 速查表
• 更新日志

集群成员

ACMI 在 Mad EZ Media 集群中用作通用上下文层，服务于：

• ops-center - 编排与路由
• bentley - 通信与治理
• codex - 编码与实现支持
• hermes - 深度扫描与守护检查
• android-worker - 移动桥接与通知

许可证

MIT - 版权所有 Michael Shaw / Mad EZ Media