WebPerfect MCP 服务器

一个智能化的MCP服务器，具备全自动批量处理网页就绪图片的流水线。功能包括降噪、自动色阶/曲线调整、JPEG伪影去除、4K分辨率调整、智能锐化（带阴影/高光增强）以及高级WebP转换。优化后的压缩技术能够在不牺牲质量的前提下提供更小的文件。

功能

高级图像处理流水线

1. 使用中值滤波进行强力降噪
2. 基于图像熵的智能自动色阶和曲线调整
3. 具备调制和锐化的高级纹理增强
4. 智能分辨率优化（最高支持4K）
5. 优化的WebP格式转换

工具

process_images

对一批图片应用高级增强处理并进行优化。

{
  inputDir: string;      // Directory containing input images
  outputDir: string;     // Directory for optimized output
}

资源

资源模板

• logs/{date}: 按日期（YYYY-MM-DD）访问处理日志

  {
    "date": "2024-01-20",
    "entries": [{
      "timestamp": "2024-01-20T10:00:00Z",
      "imagesProcessed": 15,
      "totalInputSize": "5.2MB",
      "totalOutputSize": "1.1MB",
      "compressionRatio": "78.8%",
      "averageProcessingTime": "1.2s"
    }]
  }
  

• stats/monthly/{month}: 月度统计信息（YYYY-MM）

  {
    "month": "2024-01",
    "totalImagesProcessed": 450,
    "averageCompressionRatio": "82%",
    "popularFormats": {
      "input": ["JPEG", "PNG"],
      "output": ["WebP"]
    },
    "totalStorageSaved": "150MB"
  }
  

静态资源

• stats/summary: 整体处理统计数据

  {
    "totalImagesProcessed": 5280,
    "averageCompressionRatio": "81%",
    "totalStorageSaved": "1.8GB",
    "popularEnhancements": [
      "noise_reduction",
      "auto_levels_curves",
      "texture_enhancement"
    ],
    "performanceMetrics": {
      "averageProcessingTime": "1.5s",
      "peakThroughput": "45 images/minute"
    }
  }
  

• config/optimization-presets: 可用的优化预设

  {
    "presets": {
      "web_standard": {
        "maxWidth": 1920,
        "format": "webp",
        "quality": 85,
        "enhancements": ["noise_reduction", "auto_levels_curves"]
      },
      "web_high_quality": {
        "maxWidth": 3840,
        "format": "webp",
        "quality": 90,
        "enhancements": [
          "noise_reduction",
          "auto_levels_curves",
          "texture_enhancement"
        ]
      },
      "thumbnail": {
        "maxWidth": 400,
        "format": "webp",
        "quality": 80,
        "enhancements": ["noise_reduction"]
      }
    }
  }
  

安装

1. 克隆仓库：

git clone https://github.com/splendasucks/webperfect-mcp-server.git
cd webperfect-mcp-server

1. 安装依赖项：

npm install

1. 构建服务器：

npm run build

与Claude一起使用

1. 将服务器添加到您的Claude MCP设置中（通常在claude_desktop_config.json里）：

{
  "mcpServers": {
    "webperfect": {
      "command": "node",
      "args": ["/path/to/webperfect-mcp-server/build/index.js"],
      "env": {}
    }
  }
}

1. 重启Claude以加载MCP服务器。

2. 通过Claude的MCP工具和资源可以访问该服务器：

// Process a batch of images
<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>

// Access processing statistics
<access_mcp_resource>
<server_name>webperfect</server_name>
<uri>stats/summary</uri>
</access_mcp_resource>

系统要求

• Node.js >= 16
• Sharp 图像处理库
• Model Context Protocol SDK

许可证

MIT