Geond Agent Protocol 是一个本地优先的 MCP 服务器，用于在多个 AI 编码代理之间共享记忆、预留文件、交接任务和审查证据。它面向在同一代码仓库上协作的代理，让 Copilot Chat、Codex、Claude Code、Antigravity、Manus、CLI 代理以及支持 MCP 的工具拥有一个持久的地方来记录：发生了什么、为什么发生、改动了什么、哪些内容被预留、如何验证，以及下一位代理或审查者应该做什么。
主要能力
- 记忆：导入器将来自代理工具的会话、事件、消息、使用记录和任务历史规范化，并在持久化前对常见密钥进行脱敏。
- 代码图：Python、TypeScript 和 JavaScript 索引器连接文件、符号、导入、调用、引用和变更集。
- 预留：代理可以按 TTL 认领文件或符号，支持策略检查、续期、释放和可审计的预留事件。
- 交接：代理留下结构化的下一步行动包，包含已测试命令、阻塞项、剩余风险和证据引用。
- 仪表盘：人类和 PM/编排代理可读取紧凑的概览、活动、时间线、代码风险、使用情况、谱系、预留和交接读模型。
- 共享 PostgreSQL：本地优先设置使用 Docker PostgreSQL；团队配置可将本地进程指向 Azure 或其他 PostgreSQL 兼容后端。
使用方式 前提条件：Python 3.11+、uv、Docker with Compose、Git 和 ripgrep。具体操作系统的说明见 docs/developer_setup.md。 启动 MCP 服务器、预览或写入 MCP 客户端配置、提供只读仪表盘等命令在官方文档中给出。可直接运行 stdio MCP 服务器，也可从 Docker 镜像运行。GEOND_DATABASE_URL 将 Geond 指向 PostgreSQL；本地开发通常使用快速开始中的 Compose 数据库。团队模式可使用 GEOND_DATABASE_PROFILE=azure 加 AZURE_GEOND_DATABASE_URL 在机器间共享记忆，同时保持每个 MCP 进程本地运行。
三个代表性 MCP 工作流
- 开始协调工作：review_workspace_context -> reserve_files -> edit -> record_changeset。
- 解释先前上下文：search_dev_memory -> explain_change -> get_changeset_detail。
- 留下交接：record_agent_action -> record_handoff_summary -> list_handoff_summaries。
适用场景 适用于多个 AI 编码代理在同一仓库上协作、需要共享上下文和避免冲突的开发场景；也适用于团队希望跨机器共享代理记忆但保持本地进程的情况。
限制与注意事项 Geond 是 alpha 软件。企业 IAM、行级安全、专用 MCP 审计流、广泛 SaaS 适配器和依赖扩展的自动预留属于路线图，尚未实现。代理转录可能包含敏感信息，分享前应审查 .env、转录、截图、基准日志和仪表盘截图。不要提交私有转录、本地证据导出、本地草稿、repo、tmp、result、results 或生成的视频。项目采用 Apache-2.0 许可证。
