Skip to main content
Glama

kaeru

무엇이든 변환하세요. 당신의 기계를 떠나는 것은 없습니다. 당신의 AI 에이전트와 당신 모두가 사용하는 하나의 도구.

npx @linno-inc/kaeru --doctor     # what can this machine convert?

검증됨, 주장이 아님

아래에 나열된 모든 변환은 실제로 실제 기계에서 하나씩 실행되었으며 — 출력이 비어 있지 않음을 증명하기 위해 두 번째 도구로 다시 열렸습니다. 테스트 스위트는 코드와 함께 제공되므로 직접 카운트를 다시 실행할 수 있습니다.

운영체제

제공된 변환

실제 통과

설치된 도구

macOS 26

4,778

4,752 / 4,752

모두

Windows 11

4,062

3,708 / 3,952

ImageMagick, pandoc

Debian (Linux)

3,426

3,218 / 3,329

ImageMagick, pandoc

npm test        # re-run every combination on your machine
npm run list    # print the conversion table (this is what the numbers count)

숫자는 의도적으로 기계마다 다릅니다 — 아래 참조.

Related MCP server: File Convert MCP Server

표는 당신의 기계에 맞게 조정됩니다

kaeru는 변환기를 번들로 제공하지 않습니다. 이미 가지고 있는 변환기를 찾아서 각각에게 해당 버전이 실제로 지원하는 것이 무엇인지 묻습니다. 작동할 수 없는 변환은 절대 제공되지 않습니다.

$ npx @linno-inc/kaeru --doctor
This machine can do: 4,062 conversions

Tools:
  ✓ magick      C:\Program Files\ImageMagick-7.1.2-Q16-HDRI\magick.EXE
  ✗ ffmpeg      not found
  ...

Install these to unlock more:
  ffmpeg      +468 conversions   winget install Gyan.FFmpeg

아무것도 설치되지 않았나요? 아무 문제 없습니다 — 0개의 변환과 한 줄 설치 목록을 받게 됩니다.

두 개의 문, 하나의 엔진

문

용도

시작 방법

MCP 서버

당신의 AI 에이전트용

.mcp.json에 한 줄 추가

로컬 웹 페이지

당신

npm run ui → http://127.0.0.1:19921

둘 다 동일한 코드를 호출하므로 에이전트와 인간이 가능한 것에 대해 의견 차이를 가질 수 없습니다.

에이전트용 (MCP)

{ "mcpServers": { "kaeru": { "command": "npx", "args": ["-y", "@linno-inc/kaeru"] } } }

하나의 도구, convert. 불가능한 것을 요청하면 해당 입력으로 가능한 것이 무엇인지, 또는 설치할 도구를 알려줍니다.

인간용

npm run ui는 127.0.0.1에서만 단일 페이지를 엽니다. 파일을 드롭하고, 대상을 선택하고, 결과를 저장하세요. 계속 실행되지 않습니다 — Ctrl-C를 누르면 사라집니다. Docker, 데몬, 계정이 필요 없습니다.

변환하는 것

이미지 · 비디오 · 오디오 · 문서 (md, html, tex, docx, odt, epub, 및 약 30여 개 더) · Office 및 스프레드시트 · PDF · 3D 모델 · Parquet.

PDF는 병합, 분할, 압축 및 래스터화할 수 있습니다. 이미지, 오디오 및 PDF는 형식을 변경하지 않고 축소할 수 있습니다. 비디오 사이트에서 가져오기 위해 URL을 전달하세요.

CJK 인코딩은 자동으로 감지됩니다 (Excel의 Shift_JIS CSV도 그냥 작동합니다).

모든 결과에는 영수증이 함께 제공됩니다

Converted: csv>xlsx
Output:    /path/to/data.xlsx
Tool:      soffice
Command:   soffice --headless --convert-to xlsx --outdir /tmp/... /path/to/data.csv
Took:      3,512 ms

항상 어떤 프로그램이 파일을 건드렸는지 확인하고 수동으로 반복할 수 있습니다.

변환기 설치

kaeru는 이들을 호출합니다; 필요한 것을 설치하세요 (또는 아무것도 설치하지 않고 나중에 추가).

brew install imagemagick ffmpeg pandoc weasyprint qpdf img2pdf yt-dlp assimp duckdb ghostscript
brew install --cask libreoffice
winget install ImageMagick.ImageMagick Gyan.FFmpeg JohnMacFarlane.Pandoc QPDF.QPDF `
  yt-dlp.yt-dlp Assimp.Assimp DuckDB.cli ArtifexSoftware.GhostScript TheDocumentFoundation.LibreOffice
pip install weasyprint img2pdf
sudo apt install imagemagick ffmpeg pandoc qpdf img2pdf yt-dlp assimp-utils ghostscript libreoffice
pip install weasyprint

개인정보 보호 및 보안

  • 파일은 로컬 프로그램에 의해 처리됩니다. kaeru는 네트워크 요청을 하지 않습니다 (비디오 사이트 URL을 명시적으로 전달하는 경우 제외).

  • 웹 페이지는 127.0.0.1에 바인딩되고, 로컬호스트가 아닌 Host 헤더를 거부하며, 추측할 수 없는 ID로 결과를 반환합니다.

  • 기존 파일은 요청하지 않는 한 절대 덮어쓰지 않습니다.

  • 원격 측정 없음. 절대. 익명도, 옵트아웃도 아닌 — 없습니다.

세 개의 독립적인 모델이 2026-08-18에 소스를 검토했습니다; 모든 악용 가능한 발견은 같은 날 수정되었습니다. 하나의 알려진 위험은 수정되지 않았습니다: 신뢰할 수 없는 HTML 또는 SVG를 변환하면 출력에 로컬 파일이 포함될 수 있습니다. 세부 사항, 심각도 및 완화: SECURITY.md.

테스트

명령어

확인 내용

npm test

모든 나열된 변환이 실제로 실행되고, 출력이 다시 열리는지 확인

node test/quality.mjs

이미지가 픽셀 단위로 손실 없이 변환됨; 텍스트가 유지됨

node test/fidelity.mjs

문서가 제목, 표, 목록, 강조를 유지함

node test/languages.mjs

12개의 문자 체계가 자체 문자를 유지함

node test/platforms.mjs

도구 조회가 macOS / Windows / Linux에 대해 올바른지 확인

알려진 격차는 기록되어 있으며 숨겨지지 않았습니다 — docs/ 참조.

지원

이슈는 환영합니다. 이것은 1인 프로젝트입니다: 응답 시간은 약속되지 않습니다. 번들 설치 프로그램이나 지원 계약이 필요하면 이 파일 하단을 참조하세요.

라이선스

MIT. 호출하는 변환기들은 각자의 라이선스가 있습니다.


팀용 설치가 필요하거나 지원 계약이 필요하신가요? commercial 제목의 이슈를 열면 연락드리겠습니다.

Available Tools

1 tool
convertA

ファイルを別の形式に変換する(0通り・入力0形式)。変換はこの端末の中で行い、変換のためにファイルをどこへも送らない(動画サイトの URL を渡した時だけ、その取り込みで通信する)。扱うもの: 画像・動画・音声・文書(md/html/tex/docx/odt/epub ほか)・Office と表計算(CSV の文字コードは自動判別)・PDF・3Dモデル・Parquet。PDF は結合(input に複数)・切り出し(pages)・圧縮・画像化・文字の取り出し(to: txt)ができる。絵も複数渡すと1枚にまとまる(columns で横に並べる数を決める)。max で長い方の辺を画素数で収められる(縮小のみ)。同じ形式を to に指定すると、形は変えずに小さくする(画像・音声・PDF)。動画サイト(YouTube・X 等)は input に URL を渡す。対応していない組み合わせを頼むと、その入力から作れる形式の一覧が返る。出力先に既にファイルがある時は止まる(消してよいなら overwrite: true)。

ParametersJSON Schema
NameRequiredDescriptionDefault
toYes出力形式(拡張子。例: pdf)
maxNo絵の長い方の辺を、この画素数に収める(縮小のみ。元より大きくはしない)
inputYes入力ファイルの絶対パス。動画サイトの URL でもよい。PDF の結合だけ複数渡せる
pagesNoPDF から切り出すページ(例: 1-3,5)。指定しなければ全ページ
outputNo出力先の絶対パス。省略時は入力と同じ場所に置く
columnsNo絵を複数まとめる時の横に並べる数。既定は 1(縦に積む)
overwriteNo出力先に既にファイルがある時、上書きしてよいか。既定は false(黙って消さない)

TDQS

A4.5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully carries the behavioral burden and does so impressively: it discloses that conversion happens locally, the only network communication is when a video-site URL is passed, overwriting requires explicit opt-in, and unsupported requests return a format list. It also clarifies that max only shrinks and same-format output means size reduction, which prevents agent misexpectations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is information-dense and front-loaded with the core purpose and local-processing guarantee. It is written as one long paragraph, and the garbled '0通り・入力0形式' phrase is a readability defect, but every substantive sentence earns its place and no content is redundant.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a highly polymorphic tool with 7 parameters and no output schema, the description covers formats, operations, constraints, network behavior, overwrite safety, and error-response behavior. Nothing critical for invoking the tool correctly is missing; it even handles edge cases like same-format compression and unsupported requests.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, but the description adds meaning beyond every parameter: input can be a URL or multiple files for PDF merge; to can be the same format to compress; max is shrink-only; columns has a default of stacking vertically; pages defaults to all pages; overwrite defaults to false to avoid silent deletion. This is excellent value-add over the raw JSON schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly names the resource ('file') and the action ('convert to another format'), and it enumerates supported categories (image, video, audio, document, PDF, etc.). However, the opening parenthetical '0通り・入力0形式' is nonsensical and slightly undermines clarity, and the broad scope means it cannot be sharply distinguished from some conceivable conversion sibling.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives concrete usage guidance for several scenarios: PDF merging requires multiple inputs, pages extracts ranges, columns controls the grid, max shrinks only, and same-format to compresses. It also says unsupported combinations return a list of possible formats. There are no sibling tools to compare against, so it cannot give explicit when-not-to-use alternatives, which keeps it just below 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev0.10.2
    • First observedconvert

TDQS

A4.6/5.0

Scored across 1 tool

Disambiguation5/5

ツールが convert のみで、他のツールと混同する余地がまったくない。単一ツールのためエージェントが選択を誤る可能性はない。

Naming Consistency5/5

ツール名が convert という明確な動詞で統一されており、命名の不整合や混在が存在しない。単一ツールでも分かりやすい命名と言える。

Tool Count4/5

ツールは1つだけだが、ファイル変換というサーバーの目的に対して convert が広範な形式と操作をカバーしており、実用上は十分に機能する。数は少ないが、無意味に分割せず1つに集約した設計は妥当。

Completeness5/5

画像・動画・音声・文書・PDF・3Dモデル・Parquet など主要な変換対象を網羅し、PDF結合や画像連結、動画URL取り込み、上書き制御などの必要な操作も備えている。変換ドメインにおける大きな欠落は見当たらない。

Maintenance

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers