{"id":47595626,"url":"https://github.com/stepmind-amcp/amcp","last_synced_at":"2026-04-01T18:03:20.191Z","repository":{"id":345421711,"uuid":"1185828317","full_name":"stepmind-amcp/amcp","owner":"stepmind-amcp","description":"AMCP — AI Memory Communication Protocol · AI记忆通信协议","archived":false,"fork":false,"pushed_at":"2026-03-19T04:02:25.000Z","size":46,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-19T15:37:29.443Z","etag":null,"topics":["ai","ai-memory","distributed-systems","knowledge-graph","llm","memory","open-protocol","protocol","rfc","stepmind"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stepmind-amcp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-19T01:31:05.000Z","updated_at":"2026-03-19T04:02:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/stepmind-amcp/amcp","commit_stats":null,"previous_names":["stepmind-amcp/amcp"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/stepmind-amcp/amcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepmind-amcp%2Famcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepmind-amcp%2Famcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepmind-amcp%2Famcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepmind-amcp%2Famcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stepmind-amcp","download_url":"https://codeload.github.com/stepmind-amcp/amcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stepmind-amcp%2Famcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290741,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-memory","distributed-systems","knowledge-graph","llm","memory","open-protocol","protocol","rfc","stepmind"],"created_at":"2026-04-01T18:03:19.263Z","updated_at":"2026-04-01T18:03:20.174Z","avatar_url":"https://github.com/stepmind-amcp.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# AMCP — AI Memory Communication Protocol\n# AMCP — AI 记忆通信协议\n\n**Version / 版本**: `v1.0.0` · DRAFT-RFC-FINAL  \n**Status / 状态**: ![Active](https://img.shields.io/badge/status-active-brightgreen) Active · 活跃  \n**License / 许可**: Apache 2.0  \n**Community / 社区**: [stepmind-amcp.github.io](https://stepmind-amcp.github.io) · [Discussions](https://github.com/stepmind-amcp/amcp/discussions)\n\n---\n\n\u003e **逐步思考，无限进化。**\n\u003e **Step by Step, Infinite Evolution.**\n\n---\n\n## Why AMCP? / 为什么需要 AMCP？\n\nEvery AI conversation starts from zero. Knowledge accumulated in one session vanishes before the next.  \n每次 AI 对话都从零开始。上一次积累的知识，下一次全部消失。\n\nThis is not a feature. It is a missing infrastructure layer.  \n这不是特性，这是缺失的基础设施层。\n\nHTTP gave the internet a shared language for documents.  \nHTTP 给互联网提供了文档的通用语言。\n\n**AMCP gives AI a shared protocol for memory.**  \n**AMCP 给 AI 提供了记忆的通用协议。**\n\n---\n\n## What is AMCP? / 什么是 AMCP？\n\nAMCP (AI Memory Communication Protocol) is a complete **7-layer, rigorous, open protocol** for communication between AI nodes and memory infrastructure.  \nAMCP（AI 记忆通信协议）是一套完整的 **七层、刚性、开放协议**，用于 AI 节点与记忆基础设施之间的通信。\n\nUnlike existing approaches, AMCP is not a gentleman's agreement. It has:  \n不同于现有方案，AMCP 不是君子协定，它有：\n\n| Feature / 特性 | Description / 说明 |\n|---------------|-------------------|\n| **Binary wire format** / 二进制帧格式 | 50-byte header, CRC-32C, AES-256-GCM encryption / 50字节帧头，CRC-32C校验，AES-256-GCM加密 |\n| **Protocol violation enforcement** / 协议违规强制执行 | `0x00FF` forced disconnect — no silent failures / `0x00FF` 强制断开，拒绝静默漂移 |\n| **Structured knowledge format (AMF)** / 结构化知识格式 | 7 types, SPO triples, decay models, content-addressed IDs / 7种类型，主谓宾三元组，衰减模型，内容寻址ID |\n| **Context Scheduling Engine (CSE)** / 上下文调度引擎 | ROI-ranked auto assembly, deterministic, \u003c100ms / ROI排序自动组装，确定性，\u003c100ms |\n| **Distributed storage tiers** / 分层分布式存储 | Edge (offline) → Warm (LAN) → Cloud (cold) / 端侧（离线）→ 边缘（局域网）→ 云端（冷存） |\n| **Causal consistency** / 因果一致性 | HLC + content-addressing + 3-layer consistency / 混合逻辑时钟+内容寻址+三层一致性 |\n| **AMQL query language** / AMQL查询语言 | Semantic, temporal, causal queries across any backend / 跨后端语义、时态、因果查询 |\n\n---\n\n## Protocol Stack / 协议层级\n\n```\n┌─────────────────────────────────────────────────────────────────┐\n│  L7  Semantic Application / 语义应用层                           │\n│      AMQL · QEF evolution signals · SMP workflow                │\n├─────────────────────────────────────────────────────────────────┤\n│  L6  Memory Representation / 记忆表达层  (AMF Format)           │\n│      KT-FACT · KT-PITFALL · KT-PATTERN · KT-DECISION ...       │\n├─────────────────────────────────────────────────────────────────┤\n│  L5  Consistency / 一致性层                                     │\n│      Hybrid Logical Clock · causal graph · state machine        │\n├─────────────────────────────────────────────────────────────────┤\n│  L4  Routing \u0026 Scheduling / 路由调度层                          │\n│      CSE · Memory ROI · context window allocation · AMQL router │\n├─────────────────────────────────────────────────────────────────┤\n│  L3  Reliable Transport / 传输可靠层                            │\n│      50B binary frame · CRC-32C · AES-256-GCM · 0x00FF         │\n├─────────────────────────────────────────────────────────────────┤\n│  L2  Distributed Storage / 分布式存储层                         │\n│      tier-0 edge · tier-1 warm · tier-2 cloud · Gossip sync    │\n├─────────────────────────────────────────────────────────────────┤\n│  L1  Identity \u0026 Addressing / 身份寻址层                         │\n│      amcp:// URI · capability declaration · trust anchor        │\n└─────────────────────────────────────────────────────────────────┘\n```\n\nFull specification / 完整规范: [`spec/AMCP_v1.0.json`](spec/AMCP_v1.0.json)  \nHuman-readable / 人类可读: [`spec/AMCP_v1.0_spec.md`](spec/AMCP_v1.0_spec.md)\n\n---\n\n## The Vision / 愿景\n\n```\nBefore AMCP / AMCP 之前:\n\n  Claude  ──→ [session ends / 会话结束] ──→ 🗑 forgotten / 遗忘\n  GPT-4   ──→ [session ends / 会话结束] ──→ 🗑 forgotten / 遗忘\n  Gemini  ──→ [session ends / 会话结束] ──→ 🗑 forgotten / 遗忘\n\n\nAfter AMCP / AMCP 之后:\n\n  Claude  ──┐\n            ├──→ AMCP ──→ [ Knowledge Base ] ──→ persistent, evolvable, shared\n  GPT-4   ──┤            持久化、可进化、可共享的知识库\n            │\n  Gemini  ──┘\n\n  Any AI node × Any AMCP-compliant storage = interoperable memory\n  任意 AI 节点 × 任意 AMCP 兼容存储 = 互操作的记忆\n```\n\n---\n\n## Getting Started / 快速开始\n\n### Read the Spec / 阅读规范\n\n```bash\ngit clone https://github.com/stepmind-amcp/amcp\ncd amcp\n\n# Machine-readable full spec / 机器可读完整规范\ncat spec/AMCP_v1.0.json\n\n# Human-readable guide / 人类可读指南\ncat docs/quickstart.md\n\n# Conformance test definitions / 一致性测试定义\ncat spec/conformance/level-1.md\n```\n\n### Implement Level-1 / 实现 Level-1\n\nThe fastest path to AMCP compatibility is passing the 8 Level-1 conformance tests.  \n通往 AMCP 兼容性的最快路径是通过 8 项 Level-1 一致性测试。\n\n```\nT1-01  Frame magic bytes validation          帧魔数验证\nT1-02  CAPABILITY_HELLO on connect           连接时发送能力声明\nT1-03  0x00FF on protocol violation          协议违规时强制断开\nT1-04  AMF schema validation                 AMF格式验证\nT1-05  Knowledge immutability enforcement    知识不可变性\nT1-06  State machine enforcement             状态机约束\nT1-07  Checksum silent discard              校验失败静默丢弃\nT1-08  Content-addressed knowledge_id       内容寻址ID计算\n```\n\nSee [`spec/conformance/level-1.md`](spec/conformance/level-1.md) for full test definitions.  \n完整测试定义见 [`spec/conformance/level-1.md`](spec/conformance/level-1.md)。\n\n### Reference Implementations / 参考实现\n\n| Language | Repository | Conformance Level | Status |\n|----------|-----------|-------------------|--------|\n| Python | [`stepmind/amcp-python`](https://github.com/stepmind-amcp/amcp-python) | L1 target | 🚧 In development |\n| Go | [`stepmind/amcp-go`](https://github.com/stepmind-amcp/amcp-go) | L1 target | 📋 Planned |\n| TypeScript | [`stepmind/amcp-ts`](https://github.com/stepmind-amcp/amcp-ts) | L1 target | 📋 Planned |\n\n**Want to build one? / 想自己实现？** Open an issue and we'll coordinate.  \n开一个 issue，我们会协调支持。\n\n---\n\n## Conformance Program / 一致性认证\n\nAny implementation that passes our conformance test suite may register at [`stepmind/amcp-registry`](https://github.com/stepmind-amcp/amcp-registry) and use the AMCP conformance badge.  \n任何通过我们一致性测试套件的实现都可以在 [`stepmind/amcp-registry`](https://github.com/stepmind-amcp/amcp-registry) 注册并使用 AMCP 认证徽章。\n\n| Level | Description / 说明 | Tests / 测试项 |\n|-------|-------------------|--------------|\n| **Level 1** | Basic — can join AMCP network / 基础，可接入网络 | T1-01 ~ T1-08 |\n| **Level 2** | Standard — production ready / 标准，生产就绪 | + T2-01 ~ T2-08 |\n| **Level 3** | Advanced — infrastructure node / 高级，基础设施节点 | + T3-01 ~ T3-08 |\n\n---\n\n## Repository Structure / 仓库结构\n\n```\namcp/\n├── README.md                        # This file / 本文件\n├── LICENSE                          # Apache 2.0\n├── CHANGELOG.md                     # Version history / 版本历史\n├── CONTRIBUTING.md                  # Contribution guide / 贡献指南\n├── CODE_OF_CONDUCT.md               # Community norms / 社区规范\n│\n├── spec/                            # Normative specification / 规范性文档 ⚑\n│   ├── AMCP_v1.0.json               # Machine-readable full spec\n│   ├── AMCP_v1.0_spec.md            # Human-readable full spec\n│   ├── AMF_format.md                # AMF knowledge format detail\n│   ├── AMQL_reference.md            # AMQL query language reference\n│   └── conformance/\n│       ├── level-1.md               # 8 basic conformance tests\n│       ├── level-2.md               # 8 standard conformance tests\n│       └── level-3.md               # 8 advanced conformance tests\n│\n├── docs/                            # Non-normative guides / 非规范性文档\n│   ├── quickstart.md                # Getting started\n│   ├── why-amcp.md                  # Design rationale\n│   ├── comparison.md                # AMCP vs MCP vs others\n│   └── faq.md                       # FAQ\n│\n├── rfcs/                            # Protocol evolution / 协议演进\n│   ├── RFC-0001-initial-spec.md     # Founding RFC\n│   └── README.md                    # How to submit an RFC\n│\n└── community/                       # Governance / 治理\n    ├── GOVERNANCE.md                # Governance model\n    ├── TSC.md                       # Technical Steering Committee\n    └── ROADMAP.md                   # 2026-2028 roadmap\n```\n\n---\n\n## Contributing / 贡献\n\nWe welcome all contributions. Start here:  \n我们欢迎一切贡献，从这里开始：\n\n- 🐛 **Issues** — Bug reports, spec questions, improvement suggestions / 缺陷报告、规范问题、改进建议\n- 💬 **Discussions** — Design discussions, implementation questions / 设计讨论、实现问题\n- 📖 **Docs** — Translations, examples, tutorials / 翻译、示例、教程\n- 🔧 **Implement** — Build an AMCP node, run conformance tests / 实现AMCP节点，运行一致性测试\n- 📝 **RFC** — Propose protocol extensions / 提议协议扩展\n\n**Good first issues / 新手任务**: [`good first issue`](https://github.com/stepmind-amcp/amcp/labels/good%20first%20issue)\n\nFull guide: [CONTRIBUTING.md](CONTRIBUTING.md)  \n完整指南：[CONTRIBUTING.md](CONTRIBUTING.md)\n\n---\n\n## Community / 社区\n\n| Channel / 渠道 | Link |\n|---------------|------|\n| 🌐 Website / 网站 | [stepmind-amcp.github.io](https://stepmind-amcp.github.io) |\n| 💬 Discussions | [github.com/stepmind-amcp/amcp/discussions](https://github.com/stepmind-amcp/amcp/discussions) |\n| 📅 Monthly sync / 月度同步 | First Thursday UTC 14:00 / 每月第一周四 UTC 14:00 |\n\n---\n\n## License / 许可证\n\nThis specification is licensed under **Apache 2.0**.  \n本规范采用 **商业源代码许可证 1.1（Apache 2.0）** 授权。\n\n| Use case / 使用场景 | Permitted / 是否允许 |\n|--------------------|---------------------|\n| All uses / 所有用途 | ✅ Fully free / 完全免费 |\n| Commercial production / 商业生产 | ✅ Fully free / 完全免费 |\n| Modification \u0026 distribution / 修改与分发 | ✅ Fully free / 完全免费 |\n| AMCP Certified badge / AMCP认证徽章 | Pass conformance tests / 通过一致性测试 |\n\nSee [LICENSE](LICENSE) for full terms. / 完整条款见 [LICENSE](LICENSE)。\n\n---\n\n*StepMind Community · © 2026 · stepmind-amcp.github.io*  \n*逐步思考，无限进化 · Step by Step, Infinite Evolution*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstepmind-amcp%2Famcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstepmind-amcp%2Famcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstepmind-amcp%2Famcp/lists"}