MCP Server Signoz

MCP运维云端

提供方 Champion2049

运维云端 未标注 API Key 社区 / 第三方

一个智能的模型-上下文-协议(MCP)服务器,作为SigNoz可观测性平台API的自然语言客户端,将人类语言查询转换为有效的SigNoz API查询。

一句话选型结论

按资料字段整理

MCP Server Signoz 属于运维云端类 MCP 服务器,传输方式未标注,API Key,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 5 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量5暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

自然语言处理TypeScript本地部署日志分析追踪分析可观测性API查询

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 5 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Server Signoz当前 5 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Champion2049上游标注的维护方 Champion2049
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.7 KB
来自项目仓库与上游目录的原文,未做删改

SigNoz MCP服务器

作为SigNoz Observability Platform API的自然语言客户端的智能模型内容协议(MCP)服务器。该服务器将有关日志和跟踪的类似人类的问题转换为有效的SigNoz API查询,从而更容易与您的可观察性数据交互。

特性

  • 自然语言查询:用简单的英语询问日志、跟踪和指标。
  • 日志和跟踪分析:
  • 使用关键字和属性过滤搜索原始日志和跟踪跨度。
  • 对日志和跟踪执行强大的聚合(计数、求和、平均值、百分位数)。
  • 上下文感知会话:设置默认服务名称和时间范围,以简化后续查询。
  • 服务发现:自动列出向SigNoz发送数据的所有可用服务。
  • 可扩展工具集:采用模块化工具架构构建,易于添加新功能。
  • TypeScript和Zod:强类型,代码健壮且可维护。

入门指南

按照以下说明在本地计算机上启动并运行服务器。

先决条件

  • Node.js(建议使用v18或更高版本)
  • npm(通常随Node.js一起提供)
  • 正在运行的SigNoz实例(云或自托管)

安装

  1. 克隆存储库:```bash
    git clone https://github.com/Champion2049/MCP_Server_SigNoz.git
    cd
1. 安装依赖项:```bash
npm install

配置

服务器需要API凭据才能连接到SigNoz实例。

  1. 创建一个 .env 项目根目录中的文件。

  2. 将以下环境变量添加到 .env 文件:```env

The base URL of your SigNoz API endpoint

For SigNoz Cloud, find this in Settings -> Ingestion Settings

Example: https://us.signoz.cloud

SIGNOZ_API_BASE_URL=""

Your SigNoz API Key

Generate this from Settings -> API Keys in your SigNoz instance

API keys can only be created/managed by users with the Admin role. If you don't have the Admin role, contact your organization's admin to create an API key for you.

SIGNOZ_API_KEY=""


将占位符值替换为实际的SigNoz URL和API密钥。

### 用法

配置后,您可以构建和运行服务器。

1. 构建TypeScript源代码:```bash
npm run build
  1. 运行服务器:```bash
    node
您应该看到一条消息,指示服务器正在运行:```
SigNoz MCP Server is running and connected via stdio.

MCP客户端配置

要将此服务器连接到MCP客户端(如聊天机器人或其他应用程序),您需要配置客户端以启动服务器。为MCP客户端创建一个配置文件,以下是一个示例配置:```json
{
"mcpServers": {
"SigNoz": {
"command": "node",
"args": ["/path/to/your/project/build/index.js"]
}
}
}


**备注**:确保 `command` 和 `args` 指向编译的正确位置 `index.js` 文件。

## 示例提示

以下是您可以向服务器询问的一些示例。

- **为您的会话设置上下文:**

- `"Set the default service to 'frontend' and the time range to the last 90 minutes."`

- **搜索特定日志:**

- `"Show me the latest logs from the 'api-gateway' service that contain the word 'error'."`
- `"Find logs for the 'payment-service' in the last 30 minutes."`

- **聚合日志数据:**

- `"Count the number of logs per service over the last hour."`
- `"Show me a graph of error logs per minute for the 'frontend' service."`

- **查找并分析痕迹:**

- `"Find traces for the 'checkout-service' that have an error."`
- `"Show me the slowest traces from the 'user-service' in the last day."`

- **计算性能指标:**

- `"What is the P99 latency for the 'api-gateway' service?"` (这将使用 `aggregate-traces` 随着 `durationNano`)
- `"Calculate the average duration of traces for the 'data-processor' service grouped by operation name."`

- **发现服务:**

- `"List all available services."`

## 工具概述

服务器公开了几个与SigNoz API交互的工具。

|工具名称|描述|参数|
| ------------------ | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `search-logs` |根据过滤器获取原始日志条目的列表。                                                      | `query`, `serviceName`, `startTimeUnix`, `endTimeUnix`, `pageSize`, `limit` |
| `aggregate-logs` |根据日志数据计算聚合指标(例如计数、平均值)。非常适合创建图表和表格。     | `aggregationFunction`, `panelType`, `groupBy`, `aggregateField`, `serviceName`, `startTimeUnix`, `endTimeUnix`, `stepInterval` |
| `search-traces` |基于过滤器获取原始跟踪跨度列表。                                                      | `serviceName`, `hasError`, `startTimeUnix`, `endTimeUnix`, `pageSize`, `limit` |
| `aggregate-traces` |根据跟踪数据计算聚合指标(例如P99延迟)。                                        | `aggregationFunction`, `groupBy`, `aggregateField`, `serviceName`, `hasError`, `startTimeUnix`, `endTimeUnix` |
| `list-services` |获取已发送数据的所有唯一服务名称的列表。|无|

## 项目结构

代码库被组织成逻辑模块,以促进关注点的分离和可维护性。```
src/
├── tools/                # Contains individual tool definitions
│   ├── aggregate-logs.ts
│   ├── aggregate-traces.ts
│   ├── list-services.ts
│   ├── search-logs.ts
│   ├── search-traces.ts
├── constants.ts          # Global constants (e.g., User-Agent)
├── index.ts              # Main application entry point (loads .env, starts server)
├── server.ts             # MCP server setup and tool registration
├── signoz-api.ts         # Helper functions for querying the SigNoz API
└── types.ts              # Core TypeScript interfaces and types

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
MCP Server Signoz 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Server Signoz 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Server Signoz 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Server Signoz 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

MCP Server Signoz 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 自然语言处理、可观测性、TypeScript、日志分析。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。