ACP检查员
⚠️ 积极发展 该项目正处于早期开发阶段。功能和文档正在积极构建中。关注此存储库以了解最新进展。
一个用于代理客户端协议(ACP)服务器和代理的可视化测试和调试工具,类似于 MCP检查员 用于模型上下文协议。
概述
ACP Inspector提供了一个开发人员友好的界面,用于测试、调试和检查代理客户端协议实现。无论您是构建ACP代理、将ACP集成到编辑器中,还是调试代理客户端通信,此工具都可以帮助您理解和验证协议流。
什么是代理客户端协议?
这 代理客户端协议(ACP) 是AI编码代理和代码编辑器之间通信的开放协议。ACP由Zed创建,可在不同编辑器和IDE之间实现可移植、可互操作的AI代理体验。
计划的功能
- 🔌 连接测试 –通过stdio和其他传输连接到ACP代理
- 🔍 会话管理 –初始化、验证和管理ACP会话
- 📨 消息检查器 –实时查看和分析JSON-RPC消息
- 🛠️ 交互式测试 –发送提示、批准权限和测试工具调用
- 📊 流量记录 –捕获、保存和回放ACP通信以进行调试
- ✅ 架构验证 验证是否符合ACP规范
- 🎨 基于Web的用户界面 –现代、基于浏览器的界面,便于访问
动机
虽然模型上下文协议具有出色的开发人员工具(MCP Inspector),但代理客户端协议生态系统目前缺乏一个全面的独立调试工具。该项目旨在通过使构建和测试ACP实现更容易来填补这一空白并加快ACP的采用。
路线图
第一阶段:核心基础设施(进行中)
- \[\]设置项目结构
- \[\]集成ACP TypeScript SDK
- \[\]建立基本的stdio传输连接
- \[\]创建代理服务器架构
第2阶段:基本检查器UI
- \[\]基于React的Web用户界面
- \[\]连接管理界面
- \[\]消息日志查看器
- \[\]会话状态显示
第三阶段:高级功能
- \[\]交互式提示测试
- \[\]工具调用模拟
- \[\]流量捕获和回放
- \[\]模式验证
- \[\]支持其他传输
第4阶段:波兰语和文件
- \[\]综合文件
- \[\]使用示例
- \[\]视频教程
- \[\]性能优化
技术栈
- 前端:React、TypeScript
- 后端:Node.js、TypeScript
- ACP-SDK: @代理客户端协议/sdk
- 协议:基于stdio的JSON-RPC 2.0(最初)
贡献
欢迎投稿!这是一个社区驱动的项目,我们希望您能帮助我们建立最佳的ACP调试体验。
如何做出贡献:
- 🐛 报告错误和问题
- 💡 建议功能和改进
- 📖 改进文档
- 🔨 提交拉取请求
请注意,这个项目才刚刚开始。请稍后回来查看贡献指南和开发设置说明。
相关项目
社区
- 讨论:使用 问题和想法
- 问题:在中报告错误和功能请求
- 协议更新:关注 @zeddotdev ACP新闻
许可证
MIT许可证——见 许可证 详细信息文件
致谢
灵感来自优秀 MCP检查员 以及代理客户端协议社区的工作。特别感谢Zed团队创建和开源ACP。
______________________________________________________________________
状态: 🚧 早期发展| 寻找贡献者:是的| 首次发布:待定
⭐ 标记此存储库以跟踪开发进度!
