使用说明(简要、清晰,便于快速上手)

  • 项目简介
    • 该仓库实现了一个 MCP 服务器,核心功能是定义并暴露 Prompts、Resources 以及与客户端的交互接口,帮助 LLM 客户端在自动化测试场景中获取上下文、执行工具、生成测试代码。服务器以标准 MCP 形式工作,支持通过 JSON-RPC 与客户端通信。
  • 主要功能点
    • MCP 服务器实现与路由:支持对 MCP 请求的处理,注册 Prompts 与 Resources,并通过 FastMCP 框架暴露接口。
    • Prompts 与 Resources 的定义:包括 GenerateWebTestRequest、GenerateApiTestRequest、FeatureDocumentation、GuidelineDocumentation、ApiDocumentation 等,用于驱动测试代码生成和文档获取。
    • 多服务器协作能力:Prompts 的描述、资源的注册,允许客户端在生成过程中调用其他 MCP 服务(如 Chrome DevTools、Postman 等)。
    • 传输与启动方式:默认通过 STDIO 启动并与客户端进行 JSON-RPC 交互,便于与 Copilot 等集成使用。
  • 安装步骤(简化版)
    • 准备 Python 环境(建议使用 Python 3.12 及以上)
    • 安装依赖(如 FastMCP 等库)
    • 直接运行 mcp_server/test_generation_server.py 启动 MCP 服务(基于 STDIO 传输)
  • 服务器配置(MCP 客户端使用的配置信息,以下为示例 JSON,具体路径和环境可按实际部署调整)
    • 配置字段说明:
      • server_name: MCP 服务器的唯一名称,客户端用来标识目标服务器
      • transport: 传输协议,常见为 stdio、websocket、sse 等,此处为 stdio
      • command: 启动该 MCP 服务器所使用的命令路径
      • args: 启动命令的参数列表,通常包含要执行的脚本路径
      • description: 该服务器的简要描述,便于客户端展示
    • 示例 JSON(用于 MCP 客户端连接和调用,实际使用时请以实际环境为准) { "server_name": "AutomationTestServer", "transport": "stdio", "command": "/usr/bin/python3", "args": ["mcp_server/test_generation_server.py"], "description": "MCP 服务器,负责自动化测试代码生成的上下文资源与提示模板提供与处理" }
  • 基本使用方法(简要操作)
    • 启动 MCP 服务器:
      • 直接运行 mcp_server/test_generation_server.py(如在合适的 Python 环境中执行)
    • 配置客户端连接信息(如 IDE/Copilot 配置处填写,具体以客户端实现为准)
    • 在 MCP 客户端中通过调用 Prompts 进行测试代码生成:
      • GenerateWebTestRequest:用于生成网页 UI 测试相关的请求模板
      • GenerateApiTestRequest:用于生成 API 测试相关的请求模板
    • 通过 Resources 提供的文档与指南,辅助测试代码的组织与实现

信息

分类

AI与计算