JinDaGe - Perses Monitoring MCP Details

article

README

🚀 Perses MCP 服务器

Perses MCP 服务器是一个本地模型上下文协议 (MCP) 服务器，它让 LLM 主机（如 Claude Desktop、VS Code、Cursor）能够以标准化的方式与 Perses 应用程序进行交互。

Perses 标志

🚀 快速开始

🔍 演示

Claude Desktop

https://github.com/user-attachments/assets/87137515-1b45-442d-a4c9-68f460a1ba4c

VS Code with GitHub Copilot

https://github.com/user-attachments/assets/b80c354a-8006-4e1f-b7f4-e123002f7dc3

💻 使用示例

🔑 先决条件

percli
PERSES_TOKEN

🎫 获取 Perses 认证令牌

使用 percli 命令行工具登录到您的 Perses 服务器：

percli login <PERSES_SERVER_URL>

成功登录后获取令牌：

percli whoami --show-token

复制令牌用于配置。

📌 集成到 Claude Desktop

将此 MCP 服务器添加到 Claude Desktop 的步骤如下：

创建或编辑 Claude Desktop 配置文件，路径为：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

您可以通过 Claude Desktop 应用轻松访问此文件，方法是导航到 Claude > 设置 > 开发人员 > 编辑配置。 2. 在配置文件中添加以下 JSON 块：

{
  "mcpServers": {
    "perses-mcp": {
      "command": "<ABSOLUTE_PATH_TO_PERSES_MCP_BINARY>",
      "args": [
        "--perses-server-url",
        "<PERSES_SERVER_URL>"
      ],
      "env": {
        "PERSES_TOKEN": "<YOUR_PERSES_TOKEN>"
      }
    }
  }
}

重启 Claude Desktop 以应用更改。

📌 集成到 VS Code with GitHub Copilot

打开 VS Code 并进入设置（File > Settings 或 Code > Preferences）。
在搜索栏中输入“GitHub Copilot”并选择相应的设置。
添加以下内容到配置中：

{
  "github.copilot.auth.token": "<YOUR_GITHUB_TOKEN>"
}

确保您的 GitHub 账户已正确授权。

🛠️ 工具

🌟 项目

| 工具 | 描述 | 必要参数 | | ---- | ---- | ---- | | perses_list_projects | 列出所有项目 | - |

🌟 看板

| 工具 | 描述 | 必要参数 | | ---- | ---- | ---- | | perses_list_dashboards | 列出特定项目的所有看板 | project |

🌟 数据源

| 工具 | 描述 | 必要参数 | | ---- | ---- | ---- | | perses_list_global_datasources | 列出所有全局数据源 | - | | perses_list_datasources | 列出特定项目的数据源 | project |

🌟 变量

| 工具 | 描述 | 必要参数 | | ---- | ---- | ---- | | perses_list_global_variables | 列出所有全局变量 | - | | perses_list_variables | 列出特定项目的变量 | project |

📄 许可证

代码根据 Apache 2.0 许可证发布。

Perses Monitoring