appsignal

AppSignal MCP 服务

还不了解 MCP？关注最新动态最简单的方式是阅读我们在 PulseMCP 上发布的每周通讯。

---

这是一个 MCP（Model Context Protocol）服务，可将 MCP 客户端与 AppSignal 的应用性能监控和错误跟踪功能集成：获取告警详情、搜索日志，并检索特定时间范围内的日志。

AppSignal 是一款全面的 APM（应用性能监控）解决方案，可帮助开发者监控应用性能、跟踪错误并调试问题。此服务直接连接到其 REST API。开始使用前，你需要注册并获取 AppSignal API Key。

本项目与 AppSignal 没有官方关联。

目录

• 亮点
• 功能
• 使用提示
• 示例
• 设置
  • 速查表
  • Claude Desktop
    • 手动设置

亮点

实时监控集成：直接在 Claude 或其他 MCP 客户端中访问应用的告警、错误和日志，实现无缝的调试与监控工作流。

强大的日志搜索功能：使用灵活的查询选项搜索应用日志，轻松查找特定问题或模式。

按时间检索日志：检索特定日期时间范围内的日志，以便集中分析事故，或调试有时效性的问题。

无需切换上下文：无需离开对话即可查看告警或搜索日志，一切都直接集成在 MCP 客户端中。

功能

此服务在 macOS 上使用 Claude Desktop 构建并经过测试，也应该适用于其他 MCP 客户端。

工具名称	描述
get_apps	获取所有可用 AppSignal 应用的列表。
select_app_id	选择一个 AppSignal 应用 ID，供后续操作使用。
get_exception_incident	获取特定异常事故的详细信息。
get_exception_incident_sample	获取特定异常事故的一个示例事件。
get_log_incident	获取特定日志事故的详细信息。
get_anomaly_incident	获取特定异常情况事故的详细信息。
search_logs	使用灵活的查询参数和筛选条件搜索应用日志。
get_log_incidents	获取日志事故列表，可选择按状态筛选（OPEN、CLOSED、WIP）。
get_exception_incidents	获取异常事故列表，可选择按状态筛选（OPEN、CLOSED、WIP）。
get_anomaly_incidents	获取异常情况事故列表，可选择按状态筛选（OPEN、CLOSED、WIP）。

使用提示

• 所有日志搜索都支持灵活的查询语法——你可以搜索精确短语、关键词，或使用 AppSignal 的查询语言
• 你可以在 AppSignal 仪表板中或通过警报通知找到警报 ID
• 结合使用这些工具来调查问题——先获取警报详情，然后搜索相关日志
• 列表工具（get_log_incidents、get_exception_incidents、get_anomaly_incidents）支持按状态筛选：
  • OPEN：需要关注的活动事件
  • CLOSED：已解决的事件
  • WIP：正在调查中的处理中事件
• 如果未提供状态筛选条件，列表工具默认只返回 OPEN 事件

开发

测试

本项目使用 Vitest 进行单元测试。每次创建拉取请求或推送到 main 分支时，都会自动运行测试。

在本地运行测试

# Install dependencies
npm run install-all

# Run tests once
npm run test:run

# Run tests in watch mode (recommended for development)
npm test

# Run tests with UI
npm run test:ui

测试结构

测试位于 tests/ 目录中：

• tests/functional/ - 各个组件的功能测试
• tests/integration/ - 使用模拟 AppSignal API 的集成测试
• tests/manual/ - 调用真实 AppSignal API 的手动测试（不会在 CI 中运行）
• tests/mocks/ - 模拟实现和测试数据

有关测试方法的更多详情，请参阅 tests/README.md。

手动测试

手动测试是端到端系统测试，用于验证与真实 AppSignal API 的完整集成。这些测试：

• 需要真实 API 凭据（APPSIGNAL_API_KEY 环境变量）
• 调用实际的 AppSignal 生产 API——不使用模拟数据
• 按照真实工作流串联 API 调用
• 不会在 CI 中运行，以避免 API 速率限制以及对外部服务的依赖
• 修改 AppsignalClient 代码或任何与外部 API 交互的代码时，应运行这些测试

手动测试套件遵循以下工作流：

1. 使用你的 API 密钥列出所有可用应用
2. 自动选择第一个应用
3. 搜索该应用中的日志
4. 测试各种搜索模式和错误场景
5. 提供详细的控制台输出，显示实际的 API 响应

运行手动测试：

# Copy .env.example to .env and add your API key
cp .env.example .env
# Edit .env to add your real API key

# Run manual tests
npm run test:manual

# Run manual tests in watch mode
npm run test:manual:watch

测试结果：

• SUCCESS ✅ - 所有关键测试均通过，完整的正常流程已完成
• WARNING ⚠️ - 核心功能正常，但部分功能无法得到完整验证（例如，没有可用数据或存在 API 限制）
• FAILURE ❌ - 集成中存在可验证的故障

测试会自动适配你的 AppSignal 数据和 API 限制。

设置

先决条件

• Node.js v24.2.0（如果已安装 nvm，请使用 nvm use）
• 一个 AppSignal API 密钥

速查表

环境变量	说明	必需	默认值	示例
APPSIGNAL_API_KEY	你的 AppSignal API 密钥。可在 appsignal.com 获取	Y	N/A	your-api-key-here
APPSIGNAL_APP_ID	你的 AppSignal 应用 ID	N	N/A	5f3e4d2c1b0a9f8e7d6c5b4a

Claude Desktop

请确保你已准备好 AppSignal API 密钥和应用 ID。

然后继续使用下方你偏好的方法配置服务。如果这是你第一次使用 MCP 服务，请确保已安装 Claude Desktop 桌面应用，并按照 MCP 官方设置说明操作。

手动设置

你需要在计算机上安装 Node，以便在终端中运行 npx 命令。如果尚未安装 Node，可以从 nodejs.org 安装。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json

Windows：%APPDATA%\Claude\claude_desktop_config.json

修改 claude_desktop_config.json 文件，添加以下内容：

{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "appsignal-mcp-server"],
      "env": {
        "APPSIGNAL_API_KEY": "your-api-key-here"
      }
    }
  }
}

重启 Claude Desktop，即可开始使用！