perses/mcp-server

MCP-сервер для Perses

Обзор

MCP-сервер Perses - это локальный сервер протокола контекста модели (MCP), который позволяет хостам LLM (OpenCode, Claude Desktop, VS Code, Cursor) взаимодействовать с приложением Perses стандартизированным способом.

Полная документация доступна в папке docs.

Демо

Открытый код

[[Т0]]

Начало работы

Предпосылки

• Бегущий экземпляр Персеса
• Бинарный сервер MCP - скачать со страницы релизов, извлечь его и сделать его исполняемым:

###1 Создать конфигурационный файл

Создайте файл конфигурации YAML (например, perses-mcp-config.yaml). См. аутентификацию для получения подробной информации о каждом методе аута.

[!ПРИМЕЧАНИЕ] Значения конфигурации решаются в этом порядке (позже выигрывают): встроенные по умолчанию [!TIP] Передача чувствительных значений auth в качестве переменных среды вместо их хранения в файле конфигурации:

** Основной аут**: [[Т2]] и [[Т3]]

Медвежий токен: PERMCP_PERSES_SERVER_AUTHORIZATION_CREDENTIALS

Переменные среды для полного списка.

OpenCode

Overview

The Perses MCP Server is a local Model Context Protocol (MCP) Server that enables the LLM hosts (OpenCode, Claude Desktop, VS Code, Cursor) to interact with the Perses Application in a standardized way.

The complete documentation is available in the docs folder.

Demo

OpenCode

https://github.com/user-attachments/assets/03706209-abef-47f2-8067-67c723537750

Getting Started

Prerequisites

• A running Perses instance
• The MCP server binary — download from the releases page, extract it, and make it executable:

  chmod +x /path/to/perses-mcp-server
  

1. Create a configuration file

Create a YAML configuration file (e.g., perses-mcp-config.yaml). See Authentication for details on each auth method.

# MCP transport mode: "stdio" or "http"
transport: stdio

# Address to listen on for HTTP transport (e.g., ":8000")
listen_address: ":8000"

# Restrict the server to read-only operations
read_only: false

# Comma-separated list of resources to register (if empty, all resources are registered)
resources: ""

# Perses server connection configuration
perses_server:
  url: "http://localhost:8080"

  # Authentication (choose one method):
  # It is recommended to use environment variables for sensitive values.
  # Refer the "Environment Variables" section.

  # Option 1: Basic authentication (login/password)
  # native_auth:
  #   login: "admin"
  #   password: "password"

  # Option 2: Bearer token (e.g., from `percli whoami --show-token`)
  # authorization:
  #   type: Bearer
  #   credentials: ""
  #   # credentialsFile: "/path/to/token/file"  # Alternative: read token from file

  # TLS configuration (optional)
  # tls_config:
  #   caFile: "/path/to/ca.pem"
  #   insecureSkipVerify: false

[!NOTE] Configuration values are resolved in this order (later wins): built-in defaults < YAML configuration file < environment variables.

Available Resources

The resources field accepts the following resource names (case-insensitive, comma-separated):