datasqrl/mcp-inspector

镜像概述

本Docker镜像包含modelcontextprotocol/inspector工具，专门用于验证SQRL（具体平台/框架）环境中MCP（Model Context Protocol，模型上下文协议）实现的正确性与合规性。通过容器化部署，提供了便捷、一致的验证环境，帮助开发者和测试人员快速检查MCP协议在SQRL上的部署是否符合规范要求。

核心功能与特性

核心功能

• MCP实现验证：对SQRL环境中的MCP协议实现进行全面检查，包括协议格式、数据交互流程、上下文管理逻辑等。
• SQRL环境兼容性检查：验证MCP实现与SQRL平台的兼容性，确保协议交互符合SQRL的运行时要求。
• 验证结果输出：生成结构化验证报告，明确指出合规项与不合规项，便于问题定位与修复。

主要特性

• 轻量级：基于精简基础镜像构建，体积小，启动速度快。
• 零依赖部署：容器化封装工具及所有依赖，无需在主机环境单独配置运行环境。
• 专注SQRL场景：针对SQRL平台特性优化验证逻辑，提升验证准确性。

使用场景

• MCP协议开发阶段：MCP协议实现者在开发过程中，通过本镜像快速验证代码逻辑是否符合协议规范。
• SQRL部署验证：在MCP实现部署至SQRL环境后，验证实际运行环境中的协议交互是否正常。
• CI/CD流程集成：作为自动化测试环节集成到CI/CD流水线，在代码提交或部署前自动执行MCP实现验证，确保交付质量。

使用方法

基本使用（Docker Run）

通过以下命令启动镜像，对目标SQRL环境中的MCP实现进行验证：

bash
docker run --rm \
  -e TARGET_SQRL_ENDPOINT="http://sqrl-instance:port" \  # 目标SQRL实例的API端点
  -e VALIDATION_TIMEOUT=30s \  # 验证超时时间（可选，默认30s）
  modelcontextprotocol/inspector-image:latest

参数说明：

• TARGET_SQRL_ENDPOINT（必填）：目标SQRL实例的访问地址，用于指定待验证的MCP实现部署位置。
• VALIDATION_TIMEOUT（可选）：验证过程的超时时间，默认30秒，格式支持s（秒）、m（分钟），如60s、5m。

挂载自定义配置（可选）

若需使用自定义验证规则或配置文件，可通过挂载本地目录至容器内的/config路径：

bash
docker run --rm \
  -e TARGET_SQRL_ENDPOINT="http://sqrl-instance:port" \
  -v /local/path/to/config:/config \  # 本地配置文件目录挂载
  modelcontextprotocol/inspector-image:latest

容器将优先读取/config目录下的validation-rules.yaml作为验证规则（若存在）。

验证结果查看

验证完成后，结果将输出至标准输出（STDOUT），格式示例：

Validation Result:
- Overall Status: PASSED/FAILED
- Passed Checks: 5/7
- Failed Checks:
  1. [ERROR] Context metadata format mismatch: expected 'model_version' field in context header
  2. [WARNING] Timeout threshold exceeds recommended value (30s > 20s)

详细日志可通过添加-e LOG_LEVEL=debug环境变量获取。

环境变量配置