perses/mcp-server

Perses를 위한 MCP 서버

개요

Perses MCP Server는 LLM 호스트 (OpenCode, Claude Desktop, VS Code, Cursor)를 활성화하는 로컬 모델 Context Protocol (MCP) 서버입니다.

완전한 문서는 docs 폴더에서 사용할 수 있습니다.

데모

오픈코드

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

시작하기

# 필수품

• 실행 Perses 인스턴스
• MCP 서버 바이너리 - 릴리스 페이지에서 다운로드, 그것을 추출하고 실행할 수:

##1. 설정파일 만들기

YAML 설정 파일 만들기 (예: perses-mcp-config.yaml). 각 auth 방법에 대한 자세한 내용은 인증 참조.

[!노트] 구성 값은 이 순서 (later wins)에서 해결됩니다. 기본 [!TIP] config 파일에 저장 대신 환경 변수로 민감한 auth 값을 전달합니다. · 기본우: PERMCP_PERSES_SERVER_NATIVE_AUTH_LOGIN 및 PERMCP_PERSES_SERVER_NATIVE_AUTH_PASSWORD] · **Bearer 토큰 **: 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):