Overtooled MCP

过冷mcp

MCP服务器，用于本地文件转换、分析和图像处理。图像、音频、视频、文档和结构化数据都在本地处理，没有上传到任何地方。

支持44种格式 横跨5个类别。 7工具 用于转换、分析、处理、合并和生成文件。

安装

npx overtooled-mcp

或全局安装：

npm install -g overtooled-mcp

需要 Node.js>=18.

配置

克劳德代码/克劳德桌面

添加到MCP设置中：

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

光标

添加 .cursor/mcp.json:

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

工具

convert_file

将文件从一种格式转换为另一种格式。

input_path: "/photos/vacation.heic"
output_format: "jpg"
options: { quality: 90 }

返回输出路径、输入/输出大小和特定格式的元数据（图像的维度、音频/视频的持续时间等）。

______________________________________________________________________

analyze_file

获取任何文件的详细元数据。对于图像：尺寸、颜色空间、DPI、EXIF。对于音频/视频：持续时间、编解码器、比特率、采样率。对于所有文件：大小、格式检测、熵。

input_path: "/photos/sunset.jpg"

输出示例：

{
  "file": "sunset.jpg",
  "size": 2457600,
  "sizeHuman": "2.3 MB",
  "format": "image/jpeg",
  "category": "image",
  "entropy": 7.45,
  "width": 3840,
  "height": 2160,
  "colorSpace": "srgb",
  "dpi": 72,
  "exif": { "Make": "Canon", "Model": "EOS 5D", "FocalLength": 50 }
}

对于音频/视频文件，返回持续时间、编解码器、比特率、采样率、频道和流详细信息。

______________________________________________________________________

process_image

应用一个或多个图像操作：调整大小、压缩、旋转、翻转、模糊、锐化、灰度、否定、剥离元数据或更改格式。操作是按顺序链接的。

操作：

input_path: "/photos/large.jpg"
operations: [
  { type: "resize", width: 1280 },
  { type: "compress", quality: 75 },
  { type: "format", format: "webp" }
]

______________________________________________________________________

merge_files

将多个文件合并为一个。支持PDF合并、图像到PDF、文本拼接和CSV合并。

自动检测：所有PDF-> pdf_merge，所有图像-> images_to_pdf，所有CSV-> csv_merge，否则-> concatenate.

input_paths: ["/docs/ch1.pdf", "/docs/ch2.pdf", "/docs/ch3.pdf"]
output_path: "/docs/combined.pdf"

______________________________________________________________________

generate_file

从头开始生成占位符/测试文件。不需要输入文件。

文本选项 （洛伦兹）：

图像选项 （带尺寸标签的占位符，需要尖锐）：

音频选项 （WAV，纯JS——不需要ffmpeg）：

视频选项 （具有测试模式的MP4/WebM需要ffmpeg）：

数据选项 （模拟JSON/CSV）：

type: "image"
output_path: "/tmp/placeholder.png"
width: 1280
height: 720
label: "Hero Image"

type: "audio"
output_path: "/tmp/test-tone.wav"
audio_type: "tone"
frequency: 1000
duration: 5
waveform: "square"

______________________________________________________________________

list_formats

列出所有支持的格式，可选择按类别或给定输入格式可以转换为的格式进行筛选。

category: "image"

input_format: "csv"    # shows what CSV can convert to

______________________________________________________________________

get_conversion_options

获取特定输出格式的可用选项及其默认值。

output_format: "mp3"

返回格式信息和可配置选项（质量、比特率、压缩级别等）。

支持格式

图像（9输入，4输出）

音频（8路输入，7路输出）

视频（6输入，6输出）

视频选项： preset （超快/快/中/慢）， maxHeight （4K/1440/1080/720/480/360）， stripAudio （布尔值）。

数据（9输入，10输出）

标记

文档（7个输入，1个输出）

跨类别： 所有图像、结构化数据和标记也可以转换为PDF。

转换规则

• 类别内： 任何输入->同一类别中的所有输出（不包括相同格式）
• PDF格式： 图像、结构化数据和标记都可以转换为PDF
• 来自PDF： PDF->图像（第一页渲染）或纯文本（提取）
• 文档->PDF： DOCX、PPTX、ODT、ODP、ODS、RTF都只能转换为PDF
• 无跨类别： 音频无法转换为图像，视频无法转换为数据等。

依赖项

必需（自动安装）： 文本和数据转换开箱即用。

可选（安装以获得完整格式支持）：

如果 ffmpeg-static 未安装，服务器将查找 ffmpeg 在您的系统PATH中。

缺少可选依赖项会产生明确的错误消息，告诉您要安装什么。

建筑

搬运来的 过冷 --179工具浏览器实用程序套件。转换引擎从客户端（Canvas、Web Audio、WebCodecs）转换为Node.js（sharp、FFmpeg、PDFKit）。

src/
  server.ts              # MCP server + tool registration
  tools/                 # 7 tool handlers
    convert-file.ts
    analyze-file.ts
    process-image.ts
    merge-files.ts
    generate-file.ts
    list-formats.ts
    get-options.ts
  engines/               # Conversion engines by category
    engine-image.ts      # sharp
    engine-audio.ts      # FFmpeg CLI
    engine-video.ts      # FFmpeg CLI
    engine-text.ts       # Pure JS
    engine-pdf.ts        # PDFKit + pdfjs-dist + mammoth
  registry/
    format-registry.ts   # Format definitions + conversion matrix
  utils/
    mime.ts              # MIME detection from extension
    ffmpeg.ts            # FFmpeg binary resolution
    ffprobe.ts           # Media metadata extraction via ffprobe
    magic-bytes.ts       # File type detection by header bytes

发动机

• 文本引擎： 纯JS。JSON、CSV、XML、YAML、TOML、INI、SQL、XLSX、Markdown、HTML。两阶段转换：解析输入->JS对象->序列化输出。
• 图像引擎： 用于解码/编码。本机处理HEIC、TIFF、SVG。
• 音频引擎： FFmpeg CLI，具有编解码器选择和比特率/质量映射功能。5分钟超时。
• 视频引擎： FFmpeg CLI具有CRF质量、分辨率缩放、GIF调色板生成功能。10分钟超时。
• PDF引擎： PDFKit用于生成，pdfjs-dist用于文本提取，猛犸象用于DOCX，pdf库用于合并。

发展

npm run build          # Compile TypeScript
npm run dev            # Watch mode
npm test               # Run tests (vitest)
npm run test:watch     # Watch mode tests
npm run lint           # Type check

许可证

麻省理工学院