返回 MCP 目录
public公开dns本地运行

claude-mcp-server-observability

这是一个Claude MCP服务器演示项目,用于展示如何通过日志读取工具实现系统可观测性,帮助用户分析日志错误并提供解决方案。

article

README

🚀 MCP服务器与Claude集成使用指南

本项目旨在帮助你将MCP服务器与Claude Desktop集成,以便利用Claude来调查日志错误等问题,为你提供错误原因分析和修复建议。

🚀 快速开始

先决条件

⚠️ 重要提示

你需要Claude Desktop才能进行此操作,使用免费账户即可。

第1步:启动MCP服务器

  • 克隆此仓库。
  • 安装依赖项,执行命令:pip install -r requirements.txt
  • 使用 python logreader.py 启动服务器。

第2步:在Claude Desktop中安装MCP服务器

打开Claude Desktop,转到 Claude > 设置 > 开发人员 并点击 编辑配置。这将打开一个文件夹并突出显示特定的JSON文件,打开该文件并将内容设置为以下内容,此步骤可使Claude Desktop知道你的MCP服务器。

{
  "mcpServers": {
    "logreader": {
            "command": "uv",
            "args": [
                "--directory",
                "/full/path/claude-mcp-server-observability",
                "run",
                "logreader.py"
            ]
    }
  }
}

第3步:启动Claude

你应该会看到一个小的“连接器”图标,点击它,应该会显示一个已安装的服务器,名为logreader。

第4步:要求Claude提供帮助!

开始新的聊天,然后问类似以下问题:我在3月22日注意到日志中的错误。帮我调查一下。Claude应该知道它应该使用你的MCP服务器(以及提供的三种工具)来帮助回答你的查询,Claude可能会请求权限运行这些工具,请接受权限。过一会儿(可能需要额外的提示),你应该会得到答案和建议的修复方案,例如:

  • 管道C和发布的版本很可能是导致错误的原因。
  • 你应该联系苏珊。
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端