内容
# ACP 检查器
用于测试和调试兼容 [Agent Client Protocol (ACP)](https://agentclientprotocol.com) 的代理程序。ACP 是一种开放协议，标准化了客户端程序（IDE、聊天应用程序、编排器）如何通过 JSON-RPC 与代理程序通信，从而实现跨工具和平台的互操作性。ACP 检查器灵感来自 [MCP 检查器](https://github.com/modelcontextprotocol/inspector)。
## 功能
- **连接任意 ACP 代理程序** — 通过命令行启动（例如 `kiro-cli acp`、`claude-agent-acp`）
- **完整的协议日志** — 查看每个 JSON-RPC 消息及其方向指示、方法筛选和文本搜索
- **交互式提示** — 发送提示、观察流式响应、通过 `session/cancel` 中断
- **会话管理** — 创建、列出和切换会话
- **权限请求处理** — 内联响应 `session/request_permission`
- **代理程序信息显示** — 功能、支持的提示类型、MCP 传输、身份验证方法
- **环境变量管理** — 自动从登录 shell 加载、手动编辑、传递给代理程序进程
- **输出分组** — 将流式块合并为可读块，按类型使用颜色编码
## 已测试代理程序
| 代理程序 | 命令 | 链接 |
|---|---|---|
| Kiro CLI | `kiro-cli acp` | [kiro.dev/docs/cli/acp](https://kiro.dev/docs/cli/acp/) |
| Claude 代理程序 ACP | `claude-agent-acp` | [npmjs.com/package/@agentclientprotocol/claude-agent-acp](https://www.npmjs.com/package/@agentclientprotocol/claude-agent-acp) |
| Gemini CLI | `gemini --acp` | [geminicli.com/docs/cli/acp-mode](https://geminicli.com/docs/cli/acp-mode/) |
| Cursor 代理程序 | `agent acp` | [cursor.com/docs/cli/acp](https://cursor.com/docs/cli/acp) |
## 安装
从 [GitHub Releases](https://github.com/newioapp/acp-inspector/releases) 下载适用于您平台的最新版本。
| 平台 | 下载 |
|---|---|
| macOS (Apple Silicon) | `.dmg` (arm64) |
| macOS (Intel) | `.dmg` (x64) |
| Linux (x64) | `.AppImage` / `.deb` |
| Linux (arm64) | `.AppImage` / `.deb` |
## 开发
```bash
npm install
npm run dev
```
## 构建
```bash
# 本地未签名构建（macOS arm64）
./scripts/build-unsigned.sh
# 本地签名构建（macOS arm64，需要代码签名证书 + 钥匙串设置）
./scripts/build-signed.sh
```
## 许可证
[MIT](LICENSE)
MCP 市场