ICC Profile MCP 服务器

使用说明（简要概览）

• 项目简介

  • 该仓库实现了一个基于 MCP 的服务器端（后端核心为 mcp-server 相关代码），用于对 ICC 配置文件进行资源管理、工具执行以及分析、验证等工作。包含一个可运行的服务器、Web UI 后端接口，以及丰富的工具集，面向 MCP 客户端的上下文服务场景（如资源读取、工具调用、Prompts 模板渲染等）提供标准化支撑。

• 主要功能点

  • MCP 服务器核心：在 mcp-server 目录下提供 ICC Profile MCP 服务实现，注册并暴露 24 个工具（分析/维护/操作类工具）给 MCP 客户端调用，为 LLM 客户端提供分析、风控、变换等能力。
  • 资源与工具管理：支持资源上传、下载、分析任务分发、工具执行以及结果输出的统一入口。
  • 安全与稳定性：实现了多种输入校验、输出截断、沙箱执行等安全设计（部分工具在实现中包含对外部执行、OOM 限制等的处理）。
  • Web UI 接入：web_ui.py 提供 REST API 封装，方便通过网页前端查看、触发 MCP 工具、查看健康状态等。还有一个测试用例集 test_web_ui.py，覆盖 CSP、请求校验、上传、下载、XML/Prompts 等场景。
  • 构建与部署相关：README.md 中列出 iccanalyzer-lite、colorbleed_tools 的构建步骤，给出容器化/示例容器等使用方式。

• 安装与运行要点

  • 需要在系统中具备 Python3(及 MCP SDK 依赖)，并按 README 指引编译 iccanalyzer-lite 和 colorbleed_tools 相关二进制。
  • 运行 MCP 服务器时，通常以执行 icc_profile_mcp.py 作为入口来启动 MCP 服务（结合 mcp.server.FastMCP 的使用）。
  • Web UI 可以通过运行 web_ui.py 启动，提供对 24 个工具的 REST API 封装，便于测试与演示。
  • 服务器根目录下提供了 mcp-server/test_mcp.py、test_web_ui.py 等测试套件，帮助验证实现的完整性和安全边界。

• 服务器配置与客户端对接（JSON 配置）

  • MCP 客户端要连接服务器，需提供一个 JSON 配置，包含服务器名称、启动命令以及参数。示例配置要素如下（仅为配置说明，实际使用时请将路径与参数替换为你的部署环境）：
  • server_name: ICC Profile MCP
  • command: python3
  • args: ["mcp-server/icc_profile_mcp.py"]（启动服务器的脚本路径） 配置说明：
  • server_name 用于标识 MCP 服务在客户端侧的名称。
  • command 和 args 指定启动服务器的命令与参数，客户端通过这些信息建立与 MCP 服务器的连接，并通过 MCP 提供的 RPC 接口进行请求与响应。
  • 该仓库内还包含一个 Web UI，提供通过 REST API 调用工具的能力，适合开发、测试和演示使用。

• 运行与测试

  • 可直接执行 icc_profile_mcp.py 启动 MCP 服务器；另有 web_ui.py 提供基于 Starlette 的 HTTP REST API 封装，便于网页端管理与演示。
  • 依赖项如 iccanalyzer-lite、colorbleed_tools、以及 MCP SDK 组件需按 README 配置在系统中构建好。
  • 测试用例 test_web_ui.py、test_mcp.py 等覆盖了基本的 REST 接口、输入校验、上传/下载、以及 maintainer 工具相关流程，帮助确保基本行为符合 MCP 服务器的预期。

• 备注

  • 代码中对资源路径、命名、以及二进制路径存在多处显式校验与安全处理，且实现了对多种传输形式（UI/REST、JSON-RPC）的支持路线。
  • 该实现明确以 MCP 服务器的核心职责为目标：托管资源、注册工具、执行工具、并通过标准 RPC/HTTP 形式向外暴露能力，属于一个完整的、可运行的 MCP 服务器实现。

需要强调的是，该仓库包含较多辅助组件（Web UI、测试用例、Fuzzers、维护工具等），核心部分确实实现了 MCP 服务器的主体功能，并提供了可运行的服务入口以及对 MCP 客户端的对接能力，因此符合“有效的 MCP 服务器实现”的判断。