Power your agent
Yayıncıdan kurulum. PlugMCP uç noktası değildir.
Host a copy with our keys and logs.
Registry'de henüz paketlenmiş bir sürüm yok. Deponun README dosyasını izleyin.
Uzak URL mi, yoksa makinenizde bir komut mu? İki kurulum arasındaki fark
PlugMCP’de çalıştır
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.
BaşlatYayıncıdan
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
Araçlar
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
Md Anything yerel olarak stdio üzerinden çalışır.
Son kontrol: 2026-10-28. Local-first CLI + MCP server: Any file → AI-ready Markdown + JSON
