Perfrunner MCP Server logo

Perfrunner MCP Server

by sudosalim

A Model Context Protocol (MCP) server that provides information on perfrunner static configurations, such as test and cluster configurations. It's a prototype for an MCP server to interact with the perf team's infrastructure.

View on GitHub

Last updated: N/A

Perfrunner MCP Server

A Model Context Protocol (MCP) that provide info on the perfrunner static configurations. i.e test and cluster configurations.

Overview

Prototype and toy playground for an MCP server to talk with perf team's infrastructure.

Features

  • Integrates with Couchbase server for storing test configurations and results
  • Backed by Full Text Search (FTS)
  • Basic MCP

Configuration

Create a .env file in the project root with necessary configuration (you can copy and modify the provided .env.example file):

cp .env.example .env
# Edit the .env file with your specific configuration

Running the MCP Server

make

Loading Data

scripts/configs_to_server.py is used to load .test and .spec files into your Couchbase server cluster.

To load test files, use:

uv run scripts/configs_to_server.py test path/to/my/test-directory/

And to load cluster spec use:

uv run scripts/configs_to_server.py cluster path/to/my/cluster-spec-directory/