项目简介

这是一个实现了Model Context Protocol (MCP) 的服务器，允许您通过兼容的LLM客户端（如Claude Desktop）查询各种主流数字服务（如GitHub, Slack, Google Cloud Platform等）的实时状态。它通过调用这些服务的官方状态API来获取最新信息，并将结果以结构化的方式提供给LLM。

主要功能点

主流平台状态监控: 支持查询多个常用数字平台的运行状态。
详细状态信息: 提供服务整体状态以及关键组件的详细状态。
简单查询接口: 通过结构化的命令或自然语言即可轻松查询。
实时状态更新: 直接从平台状态API获取最新数据。

安装步骤

克隆或下载仓库: 使用 Git 或直接下载代码到本地目录。 'git clone https://github.com/imprvhub/mcp-status-observer' 'cd mcp-status-observer'
安装依赖: 在项目根目录运行 npm 命令安装所需的库。 'npm install'
构建项目: 运行构建命令生成可执行文件。 'npm run build'

服务器配置

MCP服务器通常需要通过LLM客户端进行配置和启动。以Claude Desktop为例，您需要编辑其配置文件 'claude_desktop_config.json' 来添加 Status Observer 的配置。

找到配置文件: 文件路径因操作系统而异：
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%\Claude\claude_desktop_config.json'
- Linux: '~/.config/Claude/claude_desktop_config.json'
编辑配置: 打开该JSON文件，在 'mcpServers' 对象中添加一个名为 'statusObserver' 的新条目。这个条目需要指定MCP服务器的启动命令和参数。
- 'command': 指定用于启动服务器的执行文件，例如 '"node"'。
- 'args': 一个字符串数组，包含传递给 'command' 的参数。数组中应包含构建后服务器代码的绝对路径，例如：'["ABSOLUTE_PATH_TO_DIRECTORY/mcp-status-observer/build/index.js"]'。请将 'ABSOLUTE_PATH_TO_DIRECTORY' 替换为您实际克隆或下载仓库的绝对路径。
- 如果您已有其他MCP服务器配置，只需将 'statusObserver' 条目添加到 'mcpServers' 对象中即可。

完成配置后保存文件。

基本使用方法

重启LLM客户端: 保存配置文件后，请重启您的LLM客户端（如Claude Desktop）以加载新的配置。
使用 'status' 命令: 在客户端的聊天界面中，您可以使用 'status' 命令与 Status Observer MCP 服务器交互。
- 'status list': 列出所有支持查询状态的平台。
- 'status --[平台ID]': 查询特定平台的详细状态，例如 'status --github'、'status --slack'。平台ID可以在 'status list' 的输出中找到，通常是平台名称的小写。
- 'status --all': 查询所有已配置平台的高级摘要状态。
自然语言交互: LLM客户端通常也能理解您的自然语言请求，并将其转化为相应的 'status' 命令。例如，您可以直接问 "What is the status of LinkedIn?" 或 "Are GitHub services operational?".

关键词

信息