使用说明

项目简介

WebPerfect MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,专注于为LLM客户端提供强大的图片处理能力。它集成了一套先进的图像处理流程,能够自动化批量优化图片,使其更适合在Web环境下使用。主要功能包括降噪、智能自动色阶和曲线调整、纹理增强、智能分辨率优化(最高达4K)以及优化的WebP转换。

主要功能点

  • 高级图像处理流程: 采用中值滤波进行强力降噪,基于图像熵的智能自动色阶和曲线,纹理增强,智能分辨率优化(最高4K),以及优化的WebP转换。
  • 'process_images' 工具: 允许用户指定输入和输出目录,批量处理和优化目录中的图片。
  • 资源管理: 提供多种资源访问,包括:
    • 日志资源: 按日期访问处理日志,记录每日的图片处理情况。
    • 统计资源: 提供月度统计数据和总体处理统计摘要,帮助用户了解图片处理服务的运行状况和效果。
    • 配置资源: 提供预设的优化配置方案,方便用户快速应用不同的优化策略。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/splendasucks/webperfect-mcp-server.git
    cd webperfect-mcp-server
  2. 安装依赖:
    npm install
  3. 构建服务器:
    npm run build

服务器配置

要将 WebPerfect MCP Server 与 MCP 客户端(如 Claude)配合使用,您需要在客户端的 MCP 服务器配置中添加以下信息。以下配置描述了如何启动 WebPerfect MCP Server 进程。

{
  "mcpServers": {
    "webperfect": {
      "command": "node",
      "args": ["/path/to/webperfect-mcp-server/build/index.js"],
      "env": {}
    }
  }
}
  • 'server name': 'webperfect' - 服务器名称,用于在MCP客户端中标识和调用。
  • 'command': 'node' - 启动服务器的命令,这里使用 Node.js 运行时环境。
  • 'args': '["/path/to/webperfect-mcp-server/build/index.js"]' - 传递给 'node' 命令的参数,指向构建后的服务器入口文件。请将 '/path/to/webperfect-mcp-server' 替换为实际的仓库路径。
  • 'env': '{}' - 环境变量,这里为空,表示不设置额外的环境变量。

基本使用方法

  1. 使用 'process_images' 工具: 通过 MCP 客户端发送工具调用请求,指定输入和输出目录来批量处理图片。

    <use_mcp_tool>
    <server_name>webperfect</server_name>
    <tool_name>process_images</tool_name>
    <arguments>
    {
      "inputDir": "/path/to/input",  //  替换为实际的输入图片目录
      "outputDir": "/path/to/output" //  替换为实际的输出目录
    }
    </arguments>
    </use_mcp_tool>
  2. 访问资源: 通过 MCP 客户端访问服务器提供的资源,例如获取统计信息或日志。

    <access_mcp_resource>
    <server_name>webperfect</server_name>
    <uri>stats/summary</uri>  //  访问总体统计摘要
    </access_mcp_resource>
    
    <access_mcp_resource>
    <server_name>webperfect</server_name>
    <uri>logs/2024-01-20</uri>  //  访问 2024-01-20 的处理日志
    </access_mcp_resource>
    
    <access_mcp_resource>
    <server_name>webperfect</server_name>
    <uri>config/optimization-presets</uri>  // 访问优化预设配置
    </access_mcp_resource>

请根据实际需求调整 'inputDir'、'outputDir' 和资源 'uri'。

信息

分类

AI与计算