适合谁
- MCP 服务器开发者
- 构建 Claude Connector 或 ChatGPT 插件的团队
- 需要工具使用分析的团队
- 寻求简单遥测集成的组织
A
38FMRS · D
AgentCat 为 MCP 服务器所有者提供了一个强大且易于集成的分析平台，通过简单的单行代码即可捕获用户意图和行为。其支持 OpenTelemetry、Datadog、Sentry 和 PostHog 等流行工具，并提供了高级身份识别和数据编辑功能。虽然对于开源项目免费，但商业用户可能需要考虑成本。总体而言，它是一个值得关注的可观测性解决方案。
AgentCat 是一个专门为 MCP 服务器所有者设计的分析平台。它通过捕获用户的意图和行为模式，帮助您了解 AI 用户真正需要您的工具提供什么功能，从而消除猜测并加速产品开发。该 SDK 还提供一种免费且简单的方式，将日志、追踪和错误等遥测数据转发到任何 OpenTelemetry 收集器或诸如 Datadog、Sentry、PostHog 等流行工具。AgentCat 作为轻量级中间件运行在您的 MCP 服务器内部，通过注入 session_id、agent_id 和 context 参数，并结合额外的 get_more_tools 工具，实现代理会话重放、跟踪调试和现有平台支持等功能。
工具能力
track
使用 AgentCat 跟踪 MCP 服务器，注入分析参数并启用遥测导出
identify
为每个调用者提供身份标识，将事件关联到一致的用户或实体
redactSensitiveInformation
在数据发送到 AgentCat 之前，对文本数据进行自定义编辑以移除敏感信息
redactEvent
通过修改事件对象或返回 null 来丢弃事件，实现事件级别的编辑或过滤
安装接入
- 在 agentcat.com 注册账户并获取项目 ID。
- 在您的 MCP 服务器项目中安装 npm 包：npm install agentcat
- 在服务器代码中导入 agentcat，并使用项目 ID 调用 agentcat.track(server, projectId)。
- （可选）配置 identify、redactSensitiveInformation 或 redactEvent 钩子，以及导出器以集成现有观测平台。
- 根据您的 MCP 服务器架构，在正确的生命周期位置（例如工厂函数内）调用 track()。
选型与风险
不适合谁
- 不使用 MCP 的开发者
- 不需要分析或遥测的简单 MCP 服务器
- 对第三方分析服务有严格隐私要求的场景
所需权限
- 需要能够修改 MCP 服务器的工具模式并注入额外参数
- 发送遥测数据和会话录制到 AgentCat 服务器或配置的导出器
- 可能需要访问 HTTP 认证信息和头部信息以进行用户识别
风险与副作用
- 通过注入参数增加上下文开销，但占用量小于 1%
- 将遥测数据发送到第三方服务可能涉及数据隐私问题，但 AgentCat 会删除敏感信息并加密存储
- 依赖 AgentCat 服务的可用性，但诊断失败不会影响工具调用
- 对于开源项目免费，但商业使用可能产生费用
常见排障
- 确保项目 ID 正确且有效
- 检查网络连接，确保 SDK 能够访问 agentcat.com 或配置的遥测端点
- 查看本地 ~/agentcat.log 文件以获取诊断信息
- 确保在正确的服务器实例上调用 track()，特别是对于无状态服务器
- 如需禁用诊断，可设置 disableDiagnostics: true 或环境变量 DISABLE_DIAGNOSTICS
使用场景
观看来宾代理如何使用您的 MCP 服务器，并了解缺失的功能
调试代理卡住或混淆的会话
将分析数据发送到 OpenTelemetry、Datadog、Sentry 或 PostHog
收集用户意图数据以指导产品开发
支持客户端
Claude Desktop完整支持