What is Perses Mcp

Perses MCP is a local Model Context Protocol (MCP) Server that facilitates standardized interactions between LLM hosts such as Claude Desktop, VS Code, and Cursor with the Perses Application.

Use cases

Use cases for Perses MCP include enhancing productivity in coding environments, enabling AI-assisted development, and facilitating communication between different AI tools.

How to use

To use Perses MCP, first install the ‘percli’ tool and obtain your Perses authentication token. Then, configure the MCP server in the respective LLM host’s configuration file by specifying the server URL and the path to the MCP binary.

Key features

Key features of Perses MCP include standardized communication protocols, seamless integration with various LLM hosts, and easy configuration through JSON files.

Where to use

Perses MCP can be used in software development environments, AI research, and applications that require interaction between language models and external applications.

MCP Server for Perses

Overview

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

Demo

Usage

Pre-requisites

• percli
• PERSES_TOKEN

Obtaining Your Perses Authentication Token

1. Login to your Perses server using the percli command line tool:

percli login <PERSES_SERVER_URL>

2. After successful login, retrieve your token:

percli whoami --show-token

1. Copy the token to use in your MCP server configuration.

Integration with Claude Desktop

To add this MCP server to Claude Desktop:

1. Create or edit the Claude Desktop configuration file at:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

You can easily access this file via the Claude Desktop app by navigating to Claude > Settings > Developer > Edit Config.

2. Add the following JSON block to the configuration file:

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

3. Restart Claude Desktop for the changes to take effect.

Integration with VS Code GitHub Copilot

To integrate the MCP server with VS Code GitHub Copilot, follow these steps:

1. Open User Settings (JSON) in VS Code:

   • Press Cmd + Shift + P (on macOS) or Ctrl + Shift + P (on other platforms).
   • Type Preferences: Open User Settings (JSON) and select it.

2. Add the following JSON block to the User Settings (JSON) file:

{
  "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. Optionally, create a file named .vscode/mcp.json in your workspace and add the same JSON block. This allows you to share the configuration with others.

Tools

Projects

Dashboards

Datasources

Variables

License

The code is licensed under an Apache 2.0 license.