← 返回目录

AgentCat

社区

框架 / SDK

为 MCP 服务器所有者打造的分析平台 🐱

这是用于开发 MCP Server 或 Agent 的框架，不是可以直接连接到客户端的 Server。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 370 / 438
Stars: ★ 124 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 4 天前
工具数: 4

38FMRS · D

AgentCat 为 MCP 服务器所有者提供了一个强大且易于集成的分析平台，通过简单的单行代码即可捕获用户意图和行为。其支持 OpenTelemetry、Datadog、Sentry 和 PostHog 等流行工具，并提供了高级身份识别和数据编辑功能。虽然对于开源项目免费，但商业用户可能需要考虑成本。总体而言，它是一个值得关注的可观测性解决方案。

最强项 · 文档质量 10/20 最弱项 · 可靠性 4/20

可靠性

4/20

安全与权限

9/20

维护活跃度

8/20

文档质量

10/20

安装易用性

7/20

查看各项评分依据

可靠性 4/20: 仅从 README 看到 happy path 示例，仓库没有提供 server manifest、CI 运行证据或测试文件；无法验证 MCP init 与工具列表握手是否真实可复现。SDK 是对外部 MCP server 的中间件，本身不提供可独立启动的 server。缺失证据，按保守原则扣分，给 4。
安全与权限 9/20: README 披露了数据流向（AgentCat 平台、可选 exporter）和脱敏/加密声明，密钥用环境变量示例，未发现真实令牌或恶意行为。但默认开启诊断上报、默认采集工具调用数据，缺少运行时确认和可验证的最小权限实现；不能从源码核实，故给 9。
维护活跃度 8/20: 有 MIT 许可证，仓库未归档，README 有迁移指南和 CI/npm 徽章，但未提供提交历史、版本发布、issue 响应或安全响应渠道的实质证据，维护持续性无法充分验证。给 8。
文档质量 10/20: README 覆盖安装、快速开始、identify/redaction/exporters 示例，并有官方文档链接；但没有工具参数说明、限制/成本说明、故障排查章节，且 manifest 未缓存，文档以营销性 README 为主。给 10。
安装易用性 7/20: 安装命令和 track() 集成示例清晰，也给出无状态服务器工厂模式；但需要先注册外部 SaaS 获取项目 ID，且缺少主流客户端连接配置示例和可验证的 CI/测试证据，故给 7。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

MCP 服务器开发者
构建 Claude Connector 或 ChatGPT 插件的团队
需要工具使用分析的团队
寻求简单遥测集成的组织

不适合谁

不使用 MCP 的开发者
不需要分析或遥测的简单 MCP 服务器
对第三方分析服务有严格隐私要求的场景

所需权限

需要能够修改 MCP 服务器的工具模式并注入额外参数
发送遥测数据和会话录制到 AgentCat 服务器或配置的导出器
可能需要访问 HTTP 认证信息和头部信息以进行用户识别

风险与副作用

通过注入参数增加上下文开销，但占用量小于 1%
将遥测数据发送到第三方服务可能涉及数据隐私问题，但 AgentCat 会删除敏感信息并加密存储
依赖 AgentCat 服务的可用性，但诊断失败不会影响工具调用
对于开源项目免费，但商业使用可能产生费用

安装接入

准备工作

运行环境：Node.js

DD_API_KEY 可选密钥 Datadog 的 API 密钥，用于将遥测数据导出到 Datadog，在 Datadog 账户设置中获取。

SENTRY_DSN 可选密钥 Sentry 项目的 DSN，用于将错误和追踪导出到 Sentry，在 Sentry 项目设置中获取。

POSTHOG_API_KEY 可选密钥 PostHog 的 API 密钥，用于将遥测数据导出到 PostHog，在 PostHog 项目设置中获取。

其他可选配置项（1 个）

DISABLE_DIAGNOSTICS 可选环境变量，设为 true 可完全关闭 AgentCat 的匿名内部诊断信号。

在 agentcat.com 注册账户并获取项目 ID。
在您的 MCP 服务器项目中安装 npm 包：npm install agentcat
在服务器代码中导入 agentcat，并使用项目 ID 调用 agentcat.track(server, projectId)。
（可选）配置 identify、redactSensitiveInformation 或 redactEvent 钩子，以及导出器以集成现有观测平台。
根据您的 MCP 服务器架构，在正确的生命周期位置（例如工厂函数内）调用 track()。

验证是否装好

安装 npm 包 agentcat 后，在 MCP 服务器代码中调用 agentcat.track(server, "proj_0000000")，然后在 AgentCat 仪表板中确认该服务器的工具调用事件开始出现。

常见排障

确保项目 ID 正确且有效
检查网络连接，确保 SDK 能够访问 agentcat.com 或配置的遥测端点
查看本地 ~/agentcat.log 文件以获取诊断信息
确保在正确的服务器实例上调用 track()，特别是对于无状态服务器
如需禁用诊断，可设置 disableDiagnostics: true 或环境变量 DISABLE_DIAGNOSTICS

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我在这个 MCP 服务器里接入 agentcat 并调用 agentcat.track 开始收集会话分析
配置 agentcat 的 identify 回调，根据请求头 x-org-id 识别用户
设置 exporters 把遥测数据同时转发到 Datadog 和 Sentry
用 redactEvent 钩子丢弃 get_credentials 工具产生的所有事件

工具能力 4

track 写入

使用 AgentCat 跟踪 MCP 服务器，注入分析参数并启用遥测导出

identify 只读

为每个调用者提供身份标识，将事件关联到一致的用户或实体

redactSensitiveInformation 只读

在数据发送到 AgentCat 之前，对文本数据进行自定义编辑以移除敏感信息

redactEvent 只读

通过修改事件对象或返回 null 来丢弃事件，实现事件级别的编辑或过滤

使用场景

观看来宾代理如何使用您的 MCP 服务器，并了解缺失的功能

调试代理卡住或混淆的会话

将分析数据发送到 OpenTelemetry、Datadog、Sentry 或 PostHog

收集用户意图数据以指导产品开发

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

AgentCat 是一个专门为 MCP 服务器所有者设计的分析平台。它通过捕获用户的意图和行为模式，帮助您了解 AI 用户真正需要您的工具提供什么功能，从而消除猜测并加速产品开发。该 SDK 还提供一种免费且简单的方式，将日志、追踪和错误等遥测数据转发到任何 OpenTelemetry 收集器或诸如 Datadog、Sentry、PostHog 等流行工具。AgentCat 作为轻量级中间件运行在您的 MCP 服务器内部，通过注入 session_id、agent_id 和 context 参数，并结合额外的 get_more_tools 工具，实现代理会话重放、跟踪调试和现有平台支持等功能。