optiq-mcp

Name: optiq-mcp
Author: Baukaalm

本地服务

github.com/Baukaalm其他0今天更新

代码仓库

关于 optiq-mcp

optiq-mcp 是用于优化项目图片的本地 MCP 服务，不会上传图片。它通过 SSIM 阈值或逐像素一致性检查验证结果后再替换文件。

主要功能

01以试运行方式分析图片
02优化 JPEG、PNG、WebP 和 AVIF
03无损或基于 SSIM 的质量检查
04原位写入或输出到目录
05调整图片尺寸并移除元数据

适用场景

01写入前预览图片大小变化
02缩减项目图片文件体积
03原位优化以保留图片路径
04移除 EXIF 和 XMP 元数据

MCP 相关

该服务通过本地 stdio 运行，并向 MCP 客户端提供图片分析与优化工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "baukaalm-optiq": {
      "command": "npx",
      "args": [
        "-y",
        "optiq-mcp"
      ]
    }
  }
}

启动命令npx -y optiq-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmoptiq-mcp0.1.0-beta.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

optiq-mcp

一个 MCP 服务，让 AI Agent 使用 Optiq 优化项目中的图像。它通过 stdio 在本地运行，不会上传任何内容。

claude mcp add optiq -- npx -y optiq-mcp          # Claude Code

{ "mcpServers": { "optiq": { "command": "npx", "args": ["-y", "optiq-mcp"] } } }

JSON 配置适用于 Claude Desktop、Cursor 和其他客户端。对于 VS Code（.vscode/mcp.json），请使用 { "servers": { "optiq": { "type": "stdio", "command": "npx", "args": ["-y", "optiq-mcp"] } }。

工具

工具	是否写入	功能
`analyze_images`	否（`readOnlyHint`）	试运行。报告每张图像所选的格式、优化前后的字节数，以及测得的质量（SSIM 或像素完全一致）
`optimize_images`	是	`write: "in-place"` 会保留格式和名称，因此代码中的引用仍然有效。`write: "out-dir"` 可能会更改格式

各模式的保证如下：