Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
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
# 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
md-anything uses three support levels:
strong: works well out of the boxbest-effort: useful, but quality depends on content and local toolsoptional: requires extra tools or an opt-in remote fallback# Single input
mda <input>
mda convert <input>
# 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
mda demo
convert --json returns a stable machine-readable envelope:
mda convert report.pdf --json
{
"input": "report.pdf",
"markdown": "# Report Title\n...",
"kind": "pdf",
"supportLevel": "strong",
"chunks": [],
"metadata": {
"extraction": "unpdf",
"extraction_status": "ok",
"support_level": "strong",
"usefulness_score": 0.85
},
"provenance": {
"documentId": "..."
},
"warnings": []
}
ingest --json returns counts plus per-document metadata:
mda ingest ./notes --json
{
"converted": 12,
"skipped": 2,
"failed": 0,
"docs": [
{
"fileName": "note.md",
"title": "My Note",
"summary": "This is a summary of the note.",
"sourceType": "pdf",
"source": "report.pdf",
"chunks": [],
"metadata": {
"extraction_status": "ok"
},
"provenance": {
"documentId": "..."
}
}
]
}
Argument errors stay machine-readable too:
{
"error": "Missing input for convert command.",
"code": "missing_input",
"examples": [
"mda convert tests/fixtures/sample.txt",
"mda convert \"https://example.com/article\""
]
}
mda mcp install claude # Claude Desktop
mda mcp install claude-code # Claude Code CLI
mda mcp install cursor # Cursor
mda mcp install windsurf # Windsurf
mda mcp install vscode # VS Code + GitHub Copilot (writes .vscode/mcp.json)
mda mcp install antigravity # Antigravity (writes .vscode/mcp.json)
mda mcp install opencode # OpenCode
Restart the client after install. For VS Code, open Command Palette → MCP: List Servers to verify.
Requires Bun in PATH. Install globally with
bun install -g md-anythingsomd-anything-mcpis available. If you usedinstall.sh, only themdabinary is installed — usebunx md-anything-mcpin manual configs below.
Claude Desktop / Claude Code / Cursor / Windsurf / OpenCode (mcpServers format):
{
"mcpServers": {
"md-anything": {
"command": "md-anything-mcp"
}
}
}
Config file locations:
VS Code / GitHub Copilot / Antigravity — create .vscode/mcp.json in your workspace:
{
"servers": {
"md-anything": {
"type": "stdio",
"command": "md-anything-mcp"
}
}
}
Using bunx instead of a global install:
{
"mcpServers": {
"md-anything": {
"command": "bunx",
"args": ["md-anything-mcp"]
}
}
}
The server also exposes resources (md-anything://doctor, md-anything://workspace/{path}) and prompts (analyze_document, summarize_document_chunks).
http:// and https:// URLs are allowedMDA_MCP_ALLOW_PRIVATE_URLS=1 to override (use with caution)The default install stays lightweight. No models are bundled, and cloud fallbacks are opt-in.
Install only what you need:
brew install poppler # pdftotext for stronger PDF extraction
brew install tesseract # OCR for images
brew install --cask calibre # ebook-convert for MOBI/AZW
brew install ffmpeg # media extraction for video/audio workflows
brew install whisper-cpp # local transcription (preferred)
whisper-cpp --download-model base.en
Also supported:
unzip for EPUB extractionwhisper (pip install openai-whisper) as a transcription fallbackOPENROUTER_API_KEY as an opt-in remote fallback for image, audio, and video workflowsUse mda doctor to see exactly what your machine can do right now.
The goal is for md-anything to become the default open-source layer for document ingestion in agent pipelines — local-first, format-agnostic, and honest about what it can and can't extract. No SaaS lock-in, no cloud required for core workflows.
Roadmap directions: DOCX/PPTX support, streaming output, semantic chunking, watch mode, Python/Go SDK wrappers.
git clone https://github.com/ojspace/md-anything
cd md-anything
bun install
Validate changes with:
bun run lint
bun run build
bun run test:required
Other useful commands:
bun test
bun run test
bun run test:fixtures
bun run src/cli.ts doctor
src/
cli.ts CLI entry point
mcp.ts MCP stdio server
mcp-support.ts MCP path/url guardrails and structured content helpers
core/ shared conversion, ingest, runtime, chunks, usefulness
providers/ one provider per input kind
formatters/ final Markdown rendering
tests/
unit/
integration/
fixtures/
generated-fixtures/
MIT
Local-first CLI + MCP server: Any file → AI-ready Markdown + JSON
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Md Anything läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Local-first CLI + MCP server: Any file → AI-ready Markdown + JSON
