https://github.com/zcaceres/markdownify-mcp
A Model Context Protocol server for converting almost anything to Markdown
https://github.com/zcaceres/markdownify-mcp
ai anthropic anthropic-ai anthropic-claude markdown mcp model-context-protocol ocr tools
Last synced: 2 months ago
JSON representation
A Model Context Protocol server for converting almost anything to Markdown
- Host: GitHub
- URL: https://github.com/zcaceres/markdownify-mcp
- Owner: zcaceres
- License: mit
- Created: 2024-12-18T21:14:52.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-01-24T14:22:44.000Z (6 months ago)
- Last Synced: 2025-04-03T03:54:36.174Z (3 months ago)
- Topics: ai, anthropic, anthropic-ai, anthropic-claude, markdown, mcp, model-context-protocol, ocr, tools
- Language: TypeScript
- Homepage:
- Size: 130 KB
- Stars: 1,175
- Watchers: 6
- Forks: 93
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- mcp-index - Markdownify MCP Server - Converts various file types and web content to Markdown format, transforming PDFs, images, audio files, and web pages into readable and shareable Markdown text. (Content Creation)
- awesome-mcp-servers - markdownify-mcp - Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It enables powerful workflows by transforming PDFs, images, audio files, and web pages into Markdown text, making it a valuable tool for the MCP ecosystem. ([Read more](/details/markdownify-mcp.md)) `markdown` `document-conversion` `file-management` `mcp` (File Management MCP Servers)
- awesome - zcaceres/markdownify-mcp - A Model Context Protocol server for converting almost anything to Markdown (TypeScript)
- StarryDivineSky - zcaceres/markdownify-mcp - mcp是一个模型上下文协议(MCP)服务器，可以将几乎任何内容转换为Markdown格式。它通过接收各种格式的内容，然后利用预定义的规则和模板将其转换为Markdown文本。该项目旨在简化内容转换流程，特别是在需要将不同来源的内容整合到Markdown文档中的场景。它支持多种输入格式，并提供灵活的配置选项以定制转换结果。核心功能在于其强大的转换引擎，能够准确地将各种数据结构和文本格式映射到Markdown语法。开发者可以通过配置MCP服务器来满足特定的转换需求，并将其集成到现有的工作流程中。该项目提供了一个便捷的API接口，方便用户进行内容转换操作。 总而言之，markdownify-mcp是一个功能强大的Markdown转换工具，可以帮助用户轻松地将各种内容转换为Markdown格式，提高工作效率。 (A01_文本生成_文本对话 / 大语言对话模型及数据)
- awesome-mcp-list - zcaceres/markdownify-mcp - mcp?style=social)](https://github.com/zcaceres/markdownify-mcp): Converts various file types and web content to Markdown. (Uncategorized / Uncategorized)
- awesome-mcp-zh - zcaceres/markdownify-mcp
- awesome-mcp-servers - zcaceres/markdownify-mcp - An MCP server to convert almost any file or web content into Markdown (Legend / 🧮 Data Science Tools)
- awesome-mcp-servers - zcaceres/markdownify-mcp - ほぼすべてのファイルやウェブコンテンツをMarkdownに変換するMCPサーバー (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
- awesome-mcp-servers - Markdownify MCP - A Model Context Protocol server for converting almost anything to Markdown (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - Markdownify MCP - A Model Context Protocol server for converting almost anything to Markdown (Table of Contents / Other Tools and Integrations)
- awesome-hacking-lists - zcaceres/markdownify-mcp - A Model Context Protocol server for converting almost anything to Markdown (TypeScript)
- awesome-mcp-servers - zcaceres/markdownify-mcp - An MCP server to convert almost any file or web content into Markdown (Legend / 🧮 Data Science Tools)
README
# Markdownify MCP Server
> Help! I need someone with a Windows computer to help me add support for Markdownify-MCP on Windows. PRs exist but I cannot test them. Post [here](https://github.com/zcaceres/markdownify-mcp/issues/18) if interested.
Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.
## Features
- Convert multiple file types to Markdown:
- PDF
- Images
- Audio (with transcription)
- DOCX
- XLSX
- PPTX
- Convert web content to Markdown:
- YouTube video transcripts
- Bing search results
- General web pages
- Retrieve existing Markdown files
## Getting Started
1. Clone this repository
2. Install dependencies:
```
pnpm install
```
Note: this will also install `uv` and related Python depdencies.
3. Build the project:
```
pnpm run build
```
4. Start the server:
```
pnpm start
```
## Development
- Use `pnpm run dev` to start the TypeScript compiler in watch mode
- Modify `src/server.ts` to customize server behavior
- Add or modify tools in `src/tools.ts`
## Usage with Desktop App
To integrate this server with a desktop app, add the following to your app's server configuration:
```js
{
"mcpServers": {
"markdownify": {
"command": "node",
"args": [
"{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
],
"env": {
// By default, the server will use the default install location of `uv`
"UV_PATH": "/path/to/uv"
}
}
}
}
```
## Available Tools
- `youtube-to-markdown`: Convert YouTube videos to Markdown
- `pdf-to-markdown`: Convert PDF files to Markdown
- `bing-search-to-markdown`: Convert Bing search results to Markdown
- `webpage-to-markdown`: Convert web pages to Markdown
- `image-to-markdown`: Convert images to Markdown with metadata
- `audio-to-markdown`: Convert audio files to Markdown with transcription
- `docx-to-markdown`: Convert DOCX files to Markdown
- `xlsx-to-markdown`: Convert XLSX files to Markdown
- `pptx-to-markdown`: Convert PPTX files to Markdown
- `get-markdown-file`: Retrieve an existing Markdown file. File extension must end with: *.md, *.markdown.
OPTIONAL: set `MD_SHARE_DIR` env var to restrict the directory from which files can be retrieved, e.g. `MD_SHARE_DIR=[SOME_PATH] pnpm run start`
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.