perses/mcp-server

パース用のMCPサーバー

概要

Perses MCP Server は、LLM ホスト (OpenCode, Claude Desktop, VS コード, Cursor) が標準化された方法で Perses アプリケーションと相互作用できるようにするローカルのモデルコンテキストプロトコル (MCP) サーバーです。

ドキュメントは docs フォルダに用意されています。

デモ

## オープンソース

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

はじめる

前提条件

• 実行中のPersesインスタンス
• MCP サーバーバイナリ — リリースページからダウンロードし、それを抽出して実行可能にします。

##1. 設定ファイルを作成する

YAML設定ファイル(例、perses-mcp-config.yaml)を作成します。 各authメソッドの詳細は認証を参照してください。

[!NOTE] 設定値は、この順番で解決されます(レイターウィン):組み込みデフォルト [!TIP] 設定ファイルに保存するのではなく、環境変数として敏感な値を渡します。 ツイート 基本auth:PERMCP_PERSES_SERVER_NATIVE_AUTH_LOGINと[PERMCP_PERSES_SERVER_NATIVE_AUTH_PASSWORD] ツイート ベアアートークン:[PERMCP_PERSES_SERVER_AUTHORIZATION_CREDENTIALS ツイート 全リストの環境変数を参照してください。

オープンコード

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):