ojspace/md-anything

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

49 stars 5 forks 质量 85 趋势 33MIT

Repository Install

本地优先CLI+MCP服务器：任何文件→AI就绪的Markdown + JSON

概览

将文件、URL和媒体转换为诚实的Markdown，供终端工作流程和MCP驱动的代理使用。 MD-Anything目前运输两种表面： - 本地优先的CLI：mda- stdio MCP服务器：md-anything-mcp - 强力：开箱即用 - 尽力而为：有用，但质量取决于内容和本地工具 - 可选：需要额外工具或选择加入的远程备份 convert --json 返回一个稳定的机器可读信封： ingest --json 返回计数及每文档元数据：论元错误也保持机器可读：安装后重启客户端。对于 VS Code，打开命令面板→ MCP：列表服务器以进行验证。

概述（AI 翻译）

将文件、URL和媒体转换为诚实的Markdown，供终端工作流程和MCP驱动的代理使用。

md-anything 目前运送两种曲面：

本地优先的CLI：mda
一个标准MCP服务器：md-anything-mcp

安装

或者用Bun或npm全局安装：

快速理智检查：

快速开始

支持的内容

md-anything 使用三个支撑水平：

strong：开箱即用效果良好
best-effort：有用，但质量取决于内容和本地工具
optional：需要额外工具或选择加入的远程备份

输入	支持	注释
`.txt`， `.md`， `.markdown`， `.json`、`.html`， `.htm`	强	本地或直接提取
`http://` / `https://` URL	强	取用 + HTML 提取
[`.pdf`	强	`unpdf` 默认情况下，`pdftotext` 可以改进部分文件
YouTube 网址	尽力而为	以文字记录为先，无法使用时的诚实备份
图片（`.png`、`.jpg`、`.webp`、`.gif`等）	尽力而为	默认仅元数据，OCR采用`tesseract`，通过OpenRouter提供更丰富的远程备份
`.epub`	尽力而为	提取取决于`unzip`;`doctor` 会告诉你是否缺少
`.mobi`， '.

本页由 AI 翻译，技术细节请以原文为准。

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

在 GitHub 查看完整 README

安装

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

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

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