OM

ojspace/md-anything

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

49 stars 5 forks Качество 85 Тренд 33MIT

Local-first CLI + MCP сервер: любой файл → AI-ready Markdown + JSON

Обзор

Преобразуйте файлы, URL-адреса и носители в честный Markdown для терминальных рабочих процессов и агентов с поддержкой MCP. В настоящее время md-anything имеет две поверхности: - первый локальный CLI: mda - сервер MCP stdio: md-anything-mcp - сильный: хорошо работает из коробки - лучший результат: полезный, но качество зависит от контента и локальных инструментов - необязательно: требует дополнительных инструментов или опции удаленного резервного копирования Конверт - Джонсон возвращает стабильный машиночитаемый конверт: ingest -json возвращает подсчеты плюс метаданные за документ: Аргументарные ошибки также остаются машиночитаемыми: Перезагрузите клиент после установки. Для VS Code откройте Command Palette → MCP: List Servers для проверки.

Обзор (машинный перевод)

Преобразуйте файлы, URL-адреса и носители в честный Markdown для терминальных рабочих процессов и агентов с поддержкой MCP.

В настоящее время корабли имеют две поверхности:

  • местный первый CLI: mda
  • сервер MCP stdio: md-anything-mcp

##Установка

Или установить глобально с Bun или npm:

Быстрая проверка здравомыслия:

Быстрый старт

Что поддерживается

[[Т3]] использует три уровня поддержки:

[4]: хорошо работает из коробки best-effort: полезно, но качество зависит от контента и локальных инструментов optional: требует дополнительных инструментов или резервного копирования

| Ввод | Поддержка | Примечания [править править код] .txt, .md, .markdown, .json, .html, .htm | сильное | Нативное или прямое извлечение | [[Т13]] /[Т14]] URL-адреса | сильная | Fetch + извлечение HTML | .pdf unpdf по умолчанию pdftotext может улучшить некоторые файлы | | URL-адреса YouTube | лучшие усилия | Transcript-first, честная обратная связь при недоступности | | Изображения .png, .jpg, .webp, .gif и т. д.] | лучшие усилия | Метаданные только по умолчанию, OCR с tesseract, более богатый удаленный запасной вариант через OpenRouter | [23][23][23][23][23]][23][23][23]][[24]][[25]][24]] [[Т[25]]] [[Т[25]]] [[Т[25]]][[Т]]] [[Т[25]]][[Т]][[Т]]] [[Т[25]]][[Т]][[Т]]][[Т]]][[Т]][[Т]]][[Т]][[Т]]][[Т]][[Т]]][[Т]]][[Т]]][[Т]][[Т]]][[Т]][[Т]]][[Т]]][[Т]][[Т]]][[Т]][[Т]]][[Т]][[Т]]][[Т]][[Т]]][[Т]]][[Т]][[Т]]][[Т]]][[ [26], [скрыто].

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

md-anything

Convert files, URLs, and media into honest Markdown for terminal workflows and MCP-powered agents.

md-anything currently ships two surfaces:

  • a local-first CLI: mda
  • a stdio MCP server: md-anything-mcp

Install

curl -fsSL https://raw.githubusercontent.com/ojspace/md-anything/main/install.sh | bash

Or install globally with Bun or npm:

bun install -g md-anything
npm install -g md-anything

Quick sanity check:

mda --help
mda doctor

Quick start

# Convert one file or URL
mda tests/fixtures/sample.txt
mda convert report.pdf
mda convert "https://example.com/article"

# Batch-convert a folder
mda ingest ./notes -o ./output -r

# Check optional tool availability
mda doctor

# Copy-paste examples
mda examples
mda demo

What is supported

md-anything uses three support levels:

  • strong: works well out of the box
  • best-effort: useful, but quality depends on content and local tools
  • optional: requires extra tools or an opt-in remote fallback
Input Support Notes
.txt, .md, .markdown, .json, .html, .htm strong Native or straightforward extraction
http:// / https:// URLs strong Fetch + HTML extraction
.pdf strong unpdf by default, pdftotext can improve some files
YouTube URLs best-effort Transcript-first, honest fallback when unavailable
Images (.png, .jpg, .webp, .gif, etc.) best-effort Metadata-only by default, OCR with tesseract, richer remote fallback via OpenRouter
.epub best-effort Extraction depends on unzip; doctor will tell you if it is missing
.mobi, .azw best-effort Requires Calibre ebook-convert
Audio (.mp3, .wav, etc.) optional Local whisper-cpp or whisper, optional OpenRouter fallback
Video (.mp4, .mov, etc.) optional Requires ffmpeg plus whisper-cpp / whisper, optional OpenRouter fallback

CLI reference

# Single input
mda 
mda convert 

# Write Markdown to a file
mda convert report.pdf -o report.md

# Omit frontmatter
mda convert report.pdf --no-frontmatter

# Machine-readable JSON
mda convert report.pdf --json

# Batch-convert a folder
mda ingest ./notes
mda ingest ./notes -o ./output
mda ingest ./vault -r -o ./output

# Environment/capability checks
mda doctor

# Help and examples
mda --help
mda examples
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "md-anything": { "command": "md-anything-mcp" } } }