grafana/mcp-k6

k6 MCP服务器镜像文档

镜像概述和主要用途

k6 MCP服务器镜像基于k6性能测试工具生态，实现了Model Context Protocol (MCP)规范，提供模型上下文管理服务。该镜像专为性能测试场景设计，用于处理测试模型的上下文信息交互、状态维护及协议通信，为k6测试脚本提供稳定的上下文服务支持，确保测试过程中模型上下文的一致性和可靠性。

核心功能和特性

• MCP协议实现：完整支持Model Context Protocol核心规范，提供上下文创建、查询、更新、删除等标准操作
• 上下文生命周期管理：内置上下文状态追踪机制，支持自定义TTL（生存时间）及自动清理策略
• k6原生集成：与k6性能测试工具无缝对接，支持测试脚本通过MCP协议实时获取或更新模型上下文
• 多存储引擎支持：提供内存存储和Redis分布式存储两种模式，适应单机测试和分布式测试场景
• 轻量级架构：基于优化的运行时环境，资源占用低，启动速度快，支持高并发上下文请求处理

使用场景和适用范围

• 复杂业务流程测试：电商购物流程、***交易序列等涉及动态模型状态的性能测试场景
• 分布式性能测试：多节点k6测试集群中，提供中心化的模型上下文共享服务
• 动态用户行为模拟：需要维护用户会话状态、权限上下文等动态信息的性能测试场景
• 持续测试环境：CI/CD流水线中，为自动化性能测试提供稳定的上下文服务支撑

使用方法和配置说明

基础部署（Docker Run）

bash
docker run -d \
  --name k6-mcp-server \
  -p 8080:8080 \
  -e MCP_PORT=8080 \
  -e LOG_LEVEL=info \
  -e CONTEXT_TTL=3600 \
  docker.xuanyuan.run/k6-mcp-server:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  k6-mcp:
    image: docker.xuanyuan.run/k6-mcp-server:latest
    container_name: k6-mcp-server
    restart: always
    ports:
      - "8080:8080"
    environment:
      - MCP_PORT=8080                  # 服务监听端口
      - LOG_LEVEL=info                 # 日志级别（debug/info/warn/error）
      - CONTEXT_TTL=3600               # 上下文默认生存时间（秒）
      - STORAGE_TYPE=redis             # 存储类型（memory/redis）
      - REDIS_URL=redis://redis:6379   # Redis连接地址（使用Redis存储时必填）
      - REDIS_PASSWORD=securepass      # Redis认证密码（如启用认证）
    depends_on:
      - redis

  redis:
    image: docker.xuanyuan.run/redis:7-alpine
    container_name: k6-mcp-redis
    restart: always
    ports:
      - "6379:6379"
    environment:
      - REDIS_PASSWORD=securepass      # Redis密码
    volumes:
      - redis-data:/data

volumes:
  redis-data:

环境变量配置说明

服务健康检查

服务启动后可通过HTTP请求验证可用性：

bash
curl http://<server-ip>:<MCP_PORT>/health

健康检查响应示例：

json
{
  "status": "ok",
  "service": "k6-mcp-server",
  "version": "latest",
  "uptime": "10m23s",
  "context_count": 42,
  "storage_type": "redis"
}