Perfrunner MCP Server

What is Perfrunner MCP Server?

Perfrunner MCP Server is a Model Context Protocol (MCP) server that provides information on perfrunner static configurations, specifically test and cluster configurations. It integrates with Couchbase Server for storing test configurations and results, backed by Full Text Search (FTS). The project is described as a prototype and toy playground for an MCP server to communicate with a performance team's infrastructure.

How to use Perfrunner MCP Server?

Copy the .env.example file to .env and edit it with your specific configuration. Run make to start the server. To load test and cluster spec files into Couchbase, use uv run scripts/configs_to_server.py test <test-directory> for test files and uv run scripts/configs_to_server.py cluster <cluster-spec-directory> for cluster spec files.

Key features of Perfrunner MCP Server

• Integrates with Couchbase Server for configuration storage.
• Backed by Full Text Search (FTS) for searching configurations.
• Provides basic MCP (Model Context Protocol) functionality.
• Supports loading test and cluster spec files into Couchbase.
• Designed for performance team infrastructure integration.

Use cases of Perfrunner MCP Server

• Retrieving test configuration details for performance testing.
• Accessing cluster specifications from a central Couchbase store.
• Loading and managing perfrunner static configurations via MCP.
• Exploring MCP integration with a performance testing toolchain.

FAQ from Perfrunner MCP Server

What data does Perfrunner MCP Server provide?

It provides information on perfrunner static configurations: test configurations and cluster configurations, stored in Couchbase and searchable via Full Text Search.

How do I load test and cluster configurations?

Use the scripts/configs_to_server.py script: uv run scripts/configs_to_server.py test <test-directory> for test files and uv run scripts/configs_to_server.py cluster <cluster-spec-directory> for cluster spec files.

What dependencies does Perfrunner MCP Server require?

It requires a Couchbase Server instance with Full Text Search (FTS) indexing enabled, and a .env file configured with the server details.

How do I configure the server?

Copy .env.example to .env and edit the file with your specific Couchbase Server endpoint, credentials, and other settings.

Is Perfrunner MCP Server production-ready?

The README explicitly describes it as a prototype and toy playground, not intended for production use.