MCP Server for Perses

基本能力

产品定位

Perses MCP Server 是一个本地化的 Model Context Protocol (MCP) 服务器，用于标准化 LLM 主机（如 Claude Desktop、VS Code、Cursor）与 Perses 应用程序之间的交互。

核心功能

1. 标准化交互：通过 MCP 协议实现 LLM 主机与 Perses 应用程序的标准化交互。
2. 多平台支持：支持 Claude Desktop、VS Code 等多种开发环境。
3. 工具集成：提供多种工具用于管理 Perses 项目、仪表盘、数据源和变量。

适用场景

1. 开发环境集成：在 Claude Desktop 或 VS Code 中集成 Perses 功能。
2. 项目管理：通过工具列表管理 Perses 项目、仪表盘、数据源和变量。

工具列表

1. Projects
2. perses_list_projects：列出所有项目。
3. Dashboards
4. perses_list_dashboards：列出特定项目的所有仪表盘。
5. Datasources
6. perses_list_global_datasources：列出所有全局数据源。
7. perses_list_datasources：列出特定项目的所有数据源。
8. Variables
9. perses_list_global_variables：列出所有全局变量。
10. perses_list_variables：列出特定项目的所有变量。

常见问题解答

1. 如何获取 Perses 认证令牌？
2. 使用 percli login 登录 Perses 服务器，然后通过 percli whoami --show-token 获取令牌。

使用教程

使用依赖

1. 安装 percli 工具。
2. 获取 PERSES_TOKEN。

安装教程

1. 获取 Perses 认证令牌 bash percli login <PERSES_SERVER_URL> percli whoami --show-token
2. 集成到 Claude Desktop
3. 编辑配置文件并添加以下 JSON 块： json { "mcpServers": { "perses-mcp": { "command": "<ABSOLUTE_PATH_TO_PERSES_MCP_BINARY>", "args": [ "--perses-server-url", "<PERSES_SERVER_URL>" ], "env": { "PERSES_TOKEN": "<PERSES_TOKEN>" } } } }
4. 集成到 VS Code GitHub Copilot
5. 在 VS Code 的用户设置 (JSON) 中添加以下 JSON 块： json { "inputs": [ { "type": "promptString", "id": "perses-token", "description": "PERSES_TOKEN to connect with Perses Application", "password": true } ], "servers": { "perses-mcp": { "command": "<ABSOLUTE_PATH_TO_PERSES_MCP_BINARY>", "args": [ "--perses-server-url", "http://localhost:8080" ], "env": { "PERSES_TOKEN": "${input:perses-token}" } } } }

调试方式

1. 确保 percli 工具已正确安装并配置。
2. 检查 PERSES_TOKEN 是否正确设置。
3. 验证配置文件路径和内容是否正确。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。